Documentation / Guides

Sandbox tier

The free GreyhoundAPI key: today's cards and results, the days ahead and the last few days, across every GB, AU and IE track. Prices, weights and weather are on the paid plans.

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, AU and IE 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.
  • Yesterday, today and ahead: cards and results, counted in whole UTC days. Older racing is on Live.
  • 60 requests/minute, capped at 50 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.