The greyhound racing API
Results, racecards and tracks for every greyhound meeting in the UK, Ireland and Australia, as JSON or CSV over a simple REST API.
Every race carries its track, grade, distance and off time in local time and UTC. Results add the finishing order, trap, greyhound, trainer, run time and the starting price as a fraction and a decimal. Today's results arrive as each race settles, the racecards list every runner before the off, and the archive goes back to 1 January 2020.
People use it for results pages and apps, for form and trainer databases, for spreadsheets that fill themselves, and for assistants that answer racing questions from real data. It holds facts only: no tips, ratings or predictions.
Start here
Get a key
Sign in with Google and your free key is made at once. It reads yesterday's results, 75 calls a day.
Get a free keyMake the first call
Send the key in the X-API-Key header. Run it right here, or copy the curl line from Quick start.
Read the answer
Every answer is data plus meta, with paging, counts and the time taken. Add format=csv for a sheet.
GET https://api.greyhoundracingapi.com/v1/results/yesterdayEvery subject
Results
Finishing order, traps, greyhounds, trainers, run times and starting prices, for yesterday, today as races settle, or any date since 2020.
Read the guideRacecards
Every race on today's card with its runners, traps and trainers, and the next races about to go, to show before the off.
Read the guideTracks
Every track covered, its id, country and the distances raced there. The track id is what the other endpoints take.
Read the guidePaging and polling
Lists come 50 races a page. Follow next_cursor, or poll today's results with since to get only new races.
pageandcursorsince=HH:MM
Every endpoint
Results
Finished races with full placings.
/v1/results/yesterdayYesterday's results, every meeting./v1/results/todayToday's results as each race settles./v1/resultsResults on any date from 2020 on.
Racecards
Races still to run, with every runner.
/v1/racecards/todayToday's racecards for every meeting./v1/racecards/upcomingThe next races coming up.
Reference
Lookups and your own account.
/v1/tracksEvery track covered, with distances./v1/usageYour plan, calls today and limits. Free to call.
Free keyRace PassArchive Pass
Popular calls
GET /v1/results/yesterday?country=GBTonight at RomfordGET /v1/racecards/today?track=romfordNew results since 19:30GET /v1/results/today?since=19:30Every Australian trackGET /v1/tracks?country=AUThe next racesGET /v1/racecards/upcoming?country=GBFor assistants and agents
MCP server
Add it to Claude, ChatGPT or Cursor and ask racing questions in plain words. Sign in once; it uses your plan.
https://greyhoundracingapi.com/mcpMCP guide and toolsAgent skill
A short file that teaches an agent how to call the API well. Add it once to your agent's skills.
https://greyhoundracingapi.com/skill.mdAbout the skillThe manual
The whole API in one markdown file: every endpoint, field and guide. Hand it to a model as context.
https://greyhoundracingapi.com/documentation/manual.mdOpen the manualllms.txt and OpenAPI
The short map for crawlers, and the OpenAPI file for code generators and API tools.
https://greyhoundracingapi.com/llms.txtopenapi.jsonPlans in short
Today's racecards and results as each race settles. 20,000 calls a day, 120 a minute.
See pricingEverything live plus every date since 2020. 50,000 calls a day, 240 a minute.
See pricingWhat is new
- The documentation moves to
/documentation, with Try it on every endpoint, an MCP tools page and/openapi.json. Changelog - Results carry
settled_atandresult_status. Every list pages bypageorcursor, 50 races a page. Changelog - Version 1: results (yesterday, today, by date from 2020), racecards (today, upcoming), tracks and usage, for the UK, Ireland and Australia, as JSON and CSV. MCP server for Race Pass and Archive Pass. Changelog
The rest
Authentication
Your key goes in X-API-Key or Authorization: Bearer, never in the address.
Rate limits
Per minute and per day by plan, with the headers that tell you where you stand.
Rate limitsQuestions people ask
How fresh are today's results?
A race appears within a few minutes of being settled. Poll /v1/results/today with since set to your last settled_at to get only the new ones. Results guide
How far back does the archive go?
To 1 January 2020, for every country. Dates before that are refused with a 400. Results by date
Can I use it in Google Sheets?
Yes. A short Apps Script keeps your key out of the sheet and fills a tab on a timer. Google Sheets guide
Can an assistant use it?
Yes. Race Pass and Archive Pass members can connect Claude, ChatGPT or Cursor to the MCP server and ask in plain words. MCP guide
Do you give tips or predictions?
No. Every endpoint returns facts only: races, runners, placings and prices. Results guide
What happens if I go over my limit?
Calls answer 429 until the minute passes, or the day resets at 00:00 UTC. Plans and limits