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. |
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=11111111-1111-4111-8111-111111111111" \ --data-urlencode "from=2026-09-01T00:00:00Z" \ --data-urlencode "to=2026-10-01T00:00:00Z" \ --data-urlencode "event_types=music,art" \ --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=55555555-5555-4555-8555-555555555555,66666666-6666-4666-8666-666666666666" \ --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/77777777-7777-4777-8777-777777777777"