{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources. Success responses include a `source` block to cite. Apizie Finance endpoints (SEC EDGAR, FRED, ECB, U.S. Treasury, GLEIF, World Bank, official:*) need a Finance plan."},"servers":[{"url":"https://apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/places:lotadata/get-events":{"get":{"operationId":"places_lotadata_get_events","summary":"Find event occurrences in the area. Returns results at specific place and time, event groups are expanded…","description":"GET /events","tags":["places"],"x-apizie-access":"read","parameters":[{"name":"category","in":"query","required":false,"description":"List of required EventCategory ids (Tier 1)","schema":{"type":"array","description":"List of required EventCategory ids (Tier 1)"}},{"name":"activity","in":"query","required":false,"description":"List of required activity type ids (compliment to category)","schema":{"type":"string","description":"List of required activity type ids (compliment to category)"}},{"name":"ambience","in":"query","required":false,"description":"List of required ambience ids","schema":{"type":"string","description":"List of required ambience ids"}},{"name":"genre","in":"query","required":false,"description":"List of required genre ids","schema":{"type":"string","description":"List of required genre ids"}},{"name":"name","in":"query","required":false,"description":"Matching on event and place names","schema":{"type":"string","description":"Matching on event and place names"}},{"name":"q","in":"query","required":false,"description":"Text query matching titles, description, various text, tags, category","schema":{"type":"string","description":"Text query matching titles, description, various text, tags, category"}},{"name":"from_day","in":"query","required":false,"description":"Start on or after date specified (2015-10-16)","schema":{"type":"string","description":"Start on or after date specified (2015-10-16)"}},{"name":"to_day","in":"query","required":false,"description":"Start on or before date specified (2015-10-16)","schema":{"type":"string","description":"Start on or before date specified (2015-10-16)"}},{"name":"capacity_min","in":"query","required":false,"description":"Min capacity at location","schema":{"type":"number","description":"Min capacity at location"}},{"name":"capacity_max","in":"query","required":false,"description":"Min capacity at location","schema":{"type":"number","description":"Min capacity at location"}},{"name":"center","in":"query","required":false,"description":"latitude,longitude of the origin point","schema":{"type":"string","description":"latitude,longitude of the origin point"}},{"name":"radius","in":"query","required":false,"description":"Distance from origin in meters","schema":{"type":"integer","description":"Distance from origin in meters"}},{"name":"bbox","in":"query","required":false,"description":"Corner of a bounding box (lat,lng). Requires 0 or 2 pairs","schema":{"type":"array","description":"Corner of a bounding box (lat,lng). Requires 0 or 2 pairs"}},{"name":"polygon","in":"query","required":false,"description":"Closed custom polygon. Ordered list of lat,lng pairs","schema":{"type":"array","description":"Closed custom polygon. Ordered list of lat,lng pairs"}},{"name":"within","in":"query","required":false,"description":"Search within specified geopolitical place id","schema":{"type":"string","description":"Search within specified geopolitical place id"}},{"name":"offset","in":"query","required":false,"description":"Return results starting at specified offset","schema":{"type":"integer","description":"Return results starting at specified offset"}},{"name":"limit","in":"query","required":false,"description":"Max results to return","schema":{"type":"integer","description":"Max results to return"}},{"name":"fieldset","in":"query","required":true,"description":"Return results starting at specified offset (summary, context, detail)","schema":{"type":"string","enum":["summary","detail","context","minicontext"],"default":"context","description":"Return results starting at specified offset (summary, context, detail)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/places:lotadata/get-events-id":{"get":{"operationId":"places_lotadata_get_events_id","summary":"Get Specific event details.","description":"GET /events/{id}","tags":["places"],"x-apizie-access":"read","parameters":[{"name":"id","in":"query","required":true,"description":"event @id","schema":{"type":"string","description":"event @id"}},{"name":"fieldset","in":"query","required":false,"schema":{"type":"string","enum":["summary","detail","context","minicontext"],"default":"summary"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/places:lotadata/get-places":{"get":{"operationId":"places_lotadata_get_places","summary":"Venues, landmarks, regions, these are all places to search.","description":"GET /places","tags":["places"],"x-apizie-access":"read","parameters":[{"name":"category","in":"query","required":false,"description":"List of required PlaceCategory ids (Tier 1)","schema":{"type":"array","description":"List of required PlaceCategory ids (Tier 1)"}},{"name":"function","in":"query","required":false,"description":"List of required PlaceFunction ids (Tier 2)","schema":{"type":"array","description":"List of required PlaceFunction ids (Tier 2)"}},{"name":"ambience","in":"query","required":false,"description":"List of required ambience ids","schema":{"type":"array","description":"List of required ambience ids"}},{"name":"tag","in":"query","required":false,"description":"List of required tags","schema":{"type":"array","description":"List of required tags"}},{"name":"type","in":"query","required":false,"description":"Specific PlaceType to return","schema":{"type":"string","description":"Specific PlaceType to return"}},{"name":"name","in":"query","required":false,"description":"Match on place names","schema":{"type":"string","description":"Match on place names"}},{"name":"exact","in":"query","required":false,"description":"Require an exact name match","schema":{"type":"boolean","description":"Require an exact name match"}},{"name":"capacity_min","in":"query","required":false,"description":"Min capacity at location","schema":{"type":"number","description":"Min capacity at location"}},{"name":"capacity_max","in":"query","required":false,"description":"Min capacity at location","schema":{"type":"number","description":"Min capacity at location"}},{"name":"street","in":"query","required":false,"description":"Address of the place or street component of the address","schema":{"type":"string","description":"Address of the place or street component of the address"}},{"name":"locality","in":"query","required":false,"description":"city, town, or neighborhood of the place","schema":{"type":"string","description":"city, town, or neighborhood of the place"}},{"name":"region","in":"query","required":false,"description":"region or state","schema":{"type":"string","description":"region or state"}},{"name":"postal_code","in":"query","required":false,"description":"Postal or zip code","schema":{"type":"string","description":"Postal or zip code"}},{"name":"country","in":"query","required":false,"description":"country component of the address","schema":{"type":"string","description":"country component of the address"}},{"name":"center","in":"query","required":false,"description":"latitude,longitude of the origin point","schema":{"type":"string","description":"latitude,longitude of the origin point"}},{"name":"radius","in":"query","required":false,"description":"Distance from origin in meters","schema":{"type":"integer","description":"Distance from origin in meters"}},{"name":"bbox","in":"query","required":false,"description":"Corner of a bounding box (lat,lng). Requires 0 or 2 pairs","schema":{"type":"array","description":"Corner of a bounding box (lat,lng). Requires 0 or 2 pairs"}},{"name":"polygon","in":"query","required":false,"description":"Closed custom polygon. Ordered list of lat,lng pairs","schema":{"type":"array","description":"Closed custom polygon. Ordered list of lat,lng pairs"}},{"name":"within","in":"query","required":false,"description":"Search within specified geopolitical place id","schema":{"type":"string","description":"Search within specified geopolitical place id"}},{"name":"offset","in":"query","required":false,"description":"Return results starting at specified offset","schema":{"type":"integer","description":"Return results starting at specified offset"}},{"name":"limit","in":"query","required":false,"description":"Max results to return","schema":{"type":"integer","description":"Max results to return"}},{"name":"fieldset","in":"query","required":true,"description":"Return results starting at specified offset (summary, context, detail)","schema":{"type":"string","enum":["summary","detail","context"],"default":"context","description":"Return results starting at specified offset (summary, context, detail)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}},"/v1/places:lotadata/get-places-id":{"get":{"operationId":"places_lotadata_get_places_id","summary":"Get specific place details","description":"GET /places/{id}","tags":["places"],"x-apizie-access":"read","parameters":[{"name":"id","in":"query","required":true,"description":"place @id","schema":{"type":"string","description":"place @id"}},{"name":"fieldset","in":"query","required":false,"schema":{"type":"string","enum":["summary","detail","context","minicontext"],"default":"summary"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"byok"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"official:company"},"data":{},"source":{"type":"object","description":"Where the data came from. Cite it.","properties":{"official":{"type":"boolean"},"provider":{"type":"string","example":"SEC EDGAR"},"publisher":{"type":"string","example":"U.S. Securities and Exchange Commission"},"url":{"type":"string","format":"uri","description":"A page a person can open to check the value"},"apiUrl":{"type":"string","format":"uri","description":"The official API URL that was called (credentials removed)"},"retrievedAt":{"type":"string","format":"date-time"},"license":{"type":"string"},"licenseUrl":{"type":"string","format":"uri"},"attribution":{"type":"string"},"notice":{"type":"string"}}},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}