Documentation / Guides

Sandbox tier

The free GreyhoundAPI sandbox: list races and list tracks across every GB and AU track, over a rolling 1-7 day window. A scoped demo — every other endpoint needs a live key.

The sandbox is a free key for seeing the API's shapes and testing your integration. No card, no trial clock. It is deliberately scoped — a small, read-only slice of the product, not a free version of it.

What a sandbox key can do

The races and tracks endpoints, and only these:

  • Races — list (GET /v1/races), view a race (GET /v1/races/{race_id}) and its runners (/runners).
  • Tracks — list (GET /v1/tracks), view a track (GET /v1/tracks/{track_id}), its races (/races) and its statistics (/stats).

List endpoints accept region=GB or region=AU. Try the listings on the sandbox page; race detail and track stats run from their docs pages.

The limits, and why

  • Every track is included — the full GB and AU fixture list, not a sample. The sandbox used to cover three tracks; that restriction was removed on 2026-08-20 because it stopped people finding the course they came to look up, while protecting nothing the window does not.
  • Races 24 hours to 7 days old — no live-day data, and nothing from the last 24 hours. The sandbox is never real-time.
  • 60 requests/minute, capped at 500 a day.

Everything else needs a live key

Any endpoint other than the two above — results, sectionals, starting prices, Betfair markets, dogs, trainers, owners, breeding, racecards and the WebSocket stream — returns 403 upgrade_required on a sandbox key. Races outside the sandbox window are excluded too. Live-day data, the deep archive, push webhooks and the stream are what the live plan is for — the limit is when, not where.