Event programs, local events and stores
Wiki home · Practical examples · All endpoints · Exact schemas
Current access: first-party * key for these direct routes. Source-field policy and coverage are separate. ASK AI can use event lookup through its own grounded tools when its scope and policy allow it.
Official program windows
| Operation | Use |
|---|---|
| GET /v1/event-programs | List stored official WPN program windows |
| GET /v1/event-programs/{key} | One window with retired versions |
The list supports as_of, kind, category, tag, set, from/to dates, upcoming, region and limit/cursor. Region is an ISO country code; dates are calculated for the requested as_of. A window can have regional effective details. These are stored observations with source, freshness and provenance, not a live fetch from Wizards.
Local events
| Operation | Use |
|---|---|
| GET /v1/events | List/filter stored events |
| GET /v1/events/upcoming | Upcoming events |
| GET /v1/events/{id} | One event |
| POST /v1/events/search | Search near a supplied location |
GET filters include kind, format, set, source, store, dates, city/region/country/postal_code, radius_km, timezone, include and limit/cursor as documented for each operation. POST search requires a location object. Results may be incomplete for an area or date span: inspect meta.coverage and per-row source/provenance. A listed entry fee is a source observation; verify with the organizer before presenting it as final checkout price.
curl -sS 'https://api.chaosdraft.com/v1/events/upcoming?city=Seattle®ion=WA&country=US&limit=10' \
-H "Authorization: Bearer $CHAOSDRAFT_FIRST_PARTY_KEY"Stores
| Operation | Use |
|---|---|
| GET /v1/stores | Search/filter stored store listings |
| GET /v1/stores/{id} | One store |
| GET /v1/stores/{id}/events | Events for that store |
Stores support filters such as city, region, country, postal_code and name. Include=provenance expands source information where allowed. These routes do not make a live request to a store, locator or geocoder. Show supplier attribution supplied by the response, including a visible TopDeck.gg link when TopDeck-sourced fields appear. Consult the OpenAPI contract for each response's required source and coverage fields.