Events
Events are time-bound destination content associated with a map and, when relevant, one or more POIs. Set BASE_URL as shown in the API overview before running these examples.
List events
Section titled “List events”GET /events
Returns a filtered, cursor-paginated list of events for a map. The response contains events, next_cursor, and total; pass next_cursor back as cursor to request the next page.
| Parameter | In | Required | Description |
|---|---|---|---|
map_id | Query | Yes | Map UUID. |
from | Query | No | Window start as an ISO 8601 timestamp. Defaults to now. |
to | Query | No | Window end as an ISO 8601 timestamp. Defaults to 30 days after from. |
event_types | Query | No | Comma-separated event types: music, food_drink, art, festival, market, family, outdoors, sport, class_workshop, nightlife, other. |
tags | Query | No | Comma-separated free-text tags. |
bbox | Query | No | Bounding box as west,south,east,north. |
near | Query | No | Point as lat,lng; use with radius_m. |
radius_m | Query | No | Radius in metres for near, from 1 to 200000. Defaults to 10000. |
limit | Query | No | Page size from 1 to 200. Defaults to 50. |
cursor | Query | No | Opaque cursor returned by the previous page. |
curl --get "$BASE_URL/events" \ --data-urlencode "map_id=c2025939-af64-4371-a281-c6818b2cd96e" \ --data-urlencode "event_types=outdoors,family" \ --data-urlencode "limit=50"Get upcoming events by POI
Section titled “Get upcoming events by POI”GET /events/upcoming-by-poi
Returns upcoming events grouped by POI ID for a comma-separated set of POIs. Each key in the response object is a requested POI ID and its value is an ordered event array.
| Parameter | In | Required | Description |
|---|---|---|---|
poi_ids | Query | Yes | Comma-separated POI UUIDs. |
from | Query | No | Window start as an ISO 8601 timestamp. |
to | Query | No | Window end as an ISO 8601 timestamp. |
limit_per_poi | Query | No | Maximum events per POI, from 1 to 20. Defaults to 5. |
curl --get "$BASE_URL/events/upcoming-by-poi" \ --data-urlencode "poi_ids=b62841a3-7121-496d-888e-e36a6957bee7,55937890-2b93-4df3-b78a-189fd9d52b21" \ --data-urlencode "limit_per_poi=5"Get an event
Section titled “Get an event”GET /events/:id
Returns one event with all of its anchored POIs. When a Wander user calls this endpoint through an account session, the response can also include is_saved; third-party anonymous reads receive the event without that field.
| Parameter | In | Required | Description |
|---|---|---|---|
id | Path | Yes | Event UUID. |
curl "$BASE_URL/events/5d8c7575-0cac-425a-86ee-db60e8f765a8"