Developers

Developer API

Read-only JSON endpoints for consuming the directory. Used internally by TheDonk (the smart dealer button links to live listings) and Am I A Donkey?(events page reads from here). Open for any other builders — if you’re wiring a pub website, a poker blog, or a local events widget, you’re welcome.

Base URL

https://directory.thedonk.shop/api/public

Access-Control-Allow-Origin: * · Cache-Control: public, s-maxage=300, stale-while-revalidate=600

GET/api/public/tournaments

List public tournaments. Filter by day-of-week, organiser slug, suburb.

https://directory.thedonk.shop/api/public/tournaments?day=2&organiser=kqp

GET/api/public/tournaments/:slug

Full tournament detail including structure and recent status updates.

https://directory.thedonk.shop/api/public/tournaments/kqp-tuesdays-the-grand

GET/api/public/tournaments/:slug/upcoming-instances

Next N fixture dates computed from day + cadence, with any organiser status overrides applied. Query: ?weeks=4.

https://directory.thedonk.shop/api/public/tournaments/kqp-tuesdays-the-grand/upcoming-instances?weeks=4

GET/api/public/venues

List venues with at least one public tournament.

https://directory.thedonk.shop/api/public/venues

GET/api/public/venues/:slug

Venue detail with all public tournaments hosted there.

https://directory.thedonk.shop/api/public/venues/hamilton-hotel

GET/api/public/series/:slug

Series (multi-day grouping) with all tournaments in it.

https://directory.thedonk.shop/api/public/series/apt-spring-classic-2026

GET/api/public/structures/:id

Blind structure JSON — shape matches TheDonk's timer structure, ready for direct import into the dealer button.

https://directory.thedonk.shop/api/public/structures/<cuid>

GET/api/public/status-updates

All organiser status updates in a date range. Query: ?from=YYYY-MM-DD&to=YYYY-MM-DD.

https://directory.thedonk.shop/api/public/status-updates?from=2026-04-21&to=2026-04-28

Need write access?

The public API is read-only. For writes: public submission form at /submit for anyone, organiser claim flow at /claim/org/:slug for organisers, and the TheDonk live-state webhook for our hardware (rolling out in Phase 3).