# GreyhoundAPI

> Greyhound racing data for Great Britain, Ireland and Australia, as a clean REST + WebSocket API. 62 REST endpoints covering Great Britain, Ireland and Australia: racecards, results, form, sectional times, starting prices and exchange prices, dogs, trainers, owners, tracks and breeding. Factual data only: no predictions, ratings or tips.

## Complete reference

- [Full manual, one file](https://greyhoundapi.com/documentation/manual.md): every endpoint, parameter, sample response and guide in a single markdown document.
- [OpenAPI](https://greyhoundapi.com/openapi.json): machine-readable API description.
- [MCP server](https://greyhoundapi.com/mcp): Model Context Protocol endpoint.

## Guides

- [Start with a free key](https://greyhoundapi.com/documentation/free-key): Everything a free GreyhoundAPI key can do, the seven endpoints it reaches, and a first request that works straight away.
- [Race Day plan overview](https://greyhoundapi.com/documentation/race-day-plan-overview): Today and yesterday, with the prices on: what the Race Day plan covers, every endpoint it reaches, and what still needs Live.
- [Getting started](https://greyhoundapi.com/documentation/getting-started): Make your first GreyhoundAPI call in under five minutes: create a key, request today's racecards and read the response envelope.
- [Authentication](https://greyhoundapi.com/documentation/authentication): How GreyhoundAPI keys work: the header format, live and sandbox prefixes, rotation with overlap, and what suspension looks like.
- [Batch requests](https://greyhoundapi.com/documentation/batch-requests): Fetch up to 50 known records in one call with the ids parameter, instead of one request per record.
- [Pagination](https://greyhoundapi.com/documentation/pagination): Two ways to page GreyhoundAPI list endpoints: simple 1-based page numbers, or opaque cursors for large and streaming exports.
- [Rate limits](https://greyhoundapi.com/documentation/rate-limits): Per-minute and monthly limits for live and sandbox GreyhoundAPI keys, the rate-limit response headers and how to back off cleanly.
- [Errors](https://greyhoundapi.com/documentation/errors): The GreyhoundAPI error shape, every error code the API returns and the HTTP statuses to expect for each.
- [Timezones & dates](https://greyhoundapi.com/documentation/timezones): How GreyhoundAPI handles time across Great Britain and Australia: UTC timestamps, track-local rendering and track-local date parameters.
- [Data integrity](https://greyhoundapi.com/documentation/data-integrity): Check what we hold for any date before you pay for it — races carded, results recorded, and anything without a result, with the reason.
- [Data freshness](https://greyhoundapi.com/documentation/data-freshness): The GreyhoundAPI race lifecycle from scheduled to complete, honest delay metrics, and how to build consumers around results_received_at.
- [Historical data](https://greyhoundapi.com/documentation/historical-data): What history GreyhoundAPI holds, which detail lives inside results versus dedicated endpoints, and how to bulk-import the archive for analysis or model training.
- [Sandbox tier](https://greyhoundapi.com/documentation/sandbox): 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.
- [MCP server for Claude and ChatGPT](https://greyhoundapi.com/documentation/mcp-server-claude-chatgpt): Connect GreyhoundAPI to Claude, ChatGPT or any Model Context Protocol client and ask about GB and Australian greyhound racing in plain English. How to set it up, which tools the assistant gets, and how it decides which to call.
- [Live odds](https://greyhoundapi.com/documentation/live-odds): Best Betfair back and lay prices, when they arrive, how often they update, and what the numbers do and do not mean.
- [What we cover](https://greyhoundapi.com/documentation/coverage): Which tracks are in the archive, how often each races, and where the edges are.
- [The whole API in one file](https://greyhoundapi.com/documentation/manual): Every endpoint, parameter, sample and guide as a single markdown document, for offline reading or for pasting into an assistant.
- [WebSocket stream](https://greyhoundapi.com/documentation/websocket): Stream greyhound results and race status changes over wss://: channels, the subscribe protocol, the replay window and connection limits.
- [Webhooks](https://greyhoundapi.com/documentation/webhooks): Push race status changes and result publication to your own HTTPS endpoint: events, the signed payload, retries and how to verify a delivery.
- [Browser extension](https://greyhoundapi.com/documentation/browser-extension): A Chrome extension that watches API status and server ping from your toolbar, with desktop alerts when the results pipeline falls behind.
- [Changelog](https://greyhoundapi.com/documentation/changelog): What changed and when: new endpoints, fields and platform features. Additive changes only within v1.
- [Weather at the track](https://greyhoundapi.com/documentation/weather): Where the weather on a race comes from, which hour it belongs to, what before_race measures, and which races carry none.

## Endpoints

- [GET /v1/racecards/today](https://greyhoundapi.com/documentation/racecards-today): Today's racecards
- [GET /v1/racecards/upcoming](https://greyhoundapi.com/documentation/racecards-upcoming): Upcoming races
- [GET /v1/races](https://greyhoundapi.com/documentation/list-races): Search races
- [GET /v1/races/{race_id}](https://greyhoundapi.com/documentation/get-race): Get a race
- [GET /v1/races/{race_id}/runners](https://greyhoundapi.com/documentation/race-runners): Race runners
- [GET /v1/races/{race_id}/weather](https://greyhoundapi.com/documentation/race-weather): Weather by Race ID
- [GET /v1/races/{race_id}/comments](https://greyhoundapi.com/documentation/race-comments): Runner comments
- [GET /v1/races/{race_id}/writeup](https://greyhoundapi.com/documentation/race-writeup): Race write-up
- [GET /v1/writeups/upcoming](https://greyhoundapi.com/documentation/writeups-upcoming): Upcoming previews
- [GET /v1/writeups/results](https://greyhoundapi.com/documentation/writeups-results): Completed write-ups
- [GET /v1/comments/vocabulary](https://greyhoundapi.com/documentation/comments-vocabulary): Comment vocabulary
- [GET /v1/races/{race_id}/result](https://greyhoundapi.com/documentation/race-result): Get a race result
- [GET /v1/races/{race_id}/status](https://greyhoundapi.com/documentation/race-status): Race status & freshness
- [GET /v1/dogs/{dog_id}/layoff](https://greyhoundapi.com/documentation/dog-layoff): Layoff record
- [GET /v1/dogs/{dog_id}/trend](https://greyhoundapi.com/documentation/dog-trend): Performance trend
- [GET /v1/races/{race_id}/precedents](https://greyhoundapi.com/documentation/race-precedents): Race precedents
- [GET /v1/races/{race_id}/field](https://greyhoundapi.com/documentation/race-field): The field
- [GET /v1/races/{race_id}/analysis](https://greyhoundapi.com/documentation/race-analysis): Race analysis
- [GET /v1/races/{race_id}/pace](https://greyhoundapi.com/documentation/race-pace): Early pace
- [GET /v1/races/{race_id}/conditions](https://greyhoundapi.com/documentation/race-conditions): Race conditions
- [GET /v1/races/{race_id}/form](https://greyhoundapi.com/documentation/race-form): Race card with form
- [GET /v1/races/{race_id}/market](https://greyhoundapi.com/documentation/race-market): Race market summary
- [GET /v1/results/today](https://greyhoundapi.com/documentation/results-today): Today's results
- [GET /v1/results/yesterday](https://greyhoundapi.com/documentation/results-yesterday): Yesterday's results
- [GET /v1/results](https://greyhoundapi.com/documentation/search-results): Search results
- [GET /v1/results/latest](https://greyhoundapi.com/documentation/latest-results): Latest results
- [GET /v1/meetings](https://greyhoundapi.com/documentation/list-meetings): Search meetings
- [GET /v1/meetings/today](https://greyhoundapi.com/documentation/meetings-today): Today's meetings
- [GET /v1/meetings/calendar](https://greyhoundapi.com/documentation/meetings-calendar): Racing calendar
- [GET /v1/meetings/{meeting_id}/analysis](https://greyhoundapi.com/documentation/meeting-analysis): Meeting analysis
- [GET /v1/meetings/{meeting_id}](https://greyhoundapi.com/documentation/get-meeting): Get a meeting
- [GET /v1/dogs/search](https://greyhoundapi.com/documentation/search-dogs): Search dogs
- [GET /v1/dogs/{dog_id}](https://greyhoundapi.com/documentation/get-dog): Get a dog
- [GET /v1/dogs/{dog_id}/form](https://greyhoundapi.com/documentation/dog-form): Dog form
- [GET /v1/dogs/{dog_id}/entries](https://greyhoundapi.com/documentation/dog-entries): Dog upcoming entries
- [GET /v1/dogs/{dog_id}/prices](https://greyhoundapi.com/documentation/dog-prices): Dog price history
- [GET /v1/dogs/{dog_id}/head-to-head/{rival_id}](https://greyhoundapi.com/documentation/dog-head-to-head): Head-to-head
- [GET /v1/dogs/{dog_id}/pace](https://greyhoundapi.com/documentation/dog-pace): Dog pace profile
- [GET /v1/dogs/{dog_id}/stats](https://greyhoundapi.com/documentation/dog-stats): Dog statistics
- [GET /v1/trainers/search](https://greyhoundapi.com/documentation/search-trainers): Search trainers
- [GET /v1/trainers/{trainer_id}](https://greyhoundapi.com/documentation/get-trainer): Get a trainer
- [GET /v1/trainers/{trainer_id}/runners](https://greyhoundapi.com/documentation/trainer-runners): Trainer upcoming runners
- [GET /v1/trainers/{trainer_id}/results](https://greyhoundapi.com/documentation/trainer-results): Trainer results
- [GET /v1/trainers/{trainer_id}/stats](https://greyhoundapi.com/documentation/trainer-stats): Trainer statistics
- [GET /v1/owners/search](https://greyhoundapi.com/documentation/search-owners): Search owners
- [GET /v1/owners/{owner_id}](https://greyhoundapi.com/documentation/get-owner): Get an owner
- [GET /v1/owners/{owner_id}/stats](https://greyhoundapi.com/documentation/owner-stats): Owner statistics
- [GET /v1/tracks](https://greyhoundapi.com/documentation/list-tracks): List tracks
- [GET /v1/tracks/{track_id}](https://greyhoundapi.com/documentation/get-track): Get a track
- [GET /v1/tracks/{track_id}/races](https://greyhoundapi.com/documentation/track-races): Races at a track
- [GET /v1/tracks/{track_id}/stats](https://greyhoundapi.com/documentation/track-stats): Track statistics
- [GET /v1/sires](https://greyhoundapi.com/documentation/list-sires): Sires
- [GET /v1/sires/{sire_id}/stats](https://greyhoundapi.com/documentation/sire-stats): Sire statistics
- [GET /v1/sires/{sire_id}/progeny](https://greyhoundapi.com/documentation/sire-progeny): Sire progeny
- [GET /v1/dams](https://greyhoundapi.com/documentation/list-dams): Dams
- [GET /v1/dams/{dam_id}/stats](https://greyhoundapi.com/documentation/dam-stats): Dam statistics
- [GET /v1/dams/{dam_id}/progeny](https://greyhoundapi.com/documentation/dam-progeny): Dam progeny
- [GET /v1/status](https://greyhoundapi.com/documentation/api-status): Pipeline status
- [GET /v1/coverage](https://greyhoundapi.com/documentation/coverage): Coverage ledger
- [GET /v1/usage](https://greyhoundapi.com/documentation/usage): Your usage
- [GET /v1/archive](https://greyhoundapi.com/documentation/archive): All statistics
- [GET /v1/reference](https://greyhoundapi.com/documentation/reference): Reference data