Today's racecards

Documentation / Racecards

Race PassArchive PassMCP tool todays_racecards

Today's racecards for every meeting. Covers the UK, Ireland and Australia.

GEThttps://api.greyhoundracingapi.com/v1/racecards/today

Try it

Your key

No key yet? The free key is made in a moment and filled in here for you. Get a free key

country

track

page

cursor

format

GET https://api.greyhoundracingapi.com/v1/racecards/today

Run works once the API is live; the code below works now with the login.

Parameters

Name	Type	What it does
`country`	string	Leave out for all three countries. GBIEAU
`track`	string	A track id from Tracks, such as `romford`.
`page`	integer	Page number, from 1. 50 races a page.
`cursor`	string	The `meta.next_cursor` from your last call, for the next page.
`format`	string	The answer format. Adding `.csv` to the path does the same as `csv`. jsoncsv

Returns

A list of races in data and paging in meta: count, page, per_page, total, total_pages and next_cursor. A field we do not have for a race is null, never left out. See Pagination.

Field	Type	What it holds
`race_id`	string	Our id for the race. Stable, safe to store.
`track`	string	Track id, as in Tracks.
`track_name`	string	Track name for display.
`country`	string	`GB`, `IE` or `AU`.
`no`	integer	Race number at the meeting.
`off`	time	Scheduled start, local to the track, `HH:MM`.
`off_utc`	datetime	Scheduled start in UTC.
`distance_m`	integer	Distance in metres.
`grade`	string	Race grade, where one is given.
`runners[].trap`	integer	Trap, 1 to 6 (1 to 8 in Australia).
`runners[].runner`	string	Greyhound name.
`runners[].runner_id`	string	Our id for the greyhound. Stable, safe to store.
`runners[].trainer`	string	Trainer name.

Example answer

A real answer from 6 October 2026, 13:10 UTC, trimmed to one race and three runners.

{
    "data": [
        {
            "race_id": "rc_945kmh69",
            "track": "sheffield",
            "track_name": "Sheffield",
            "country": "GB",
            "no": 1,
            "off": "11:01",
            "off_utc": "2026-10-06T10:01:00Z",
            "distance_m": 500,
            "grade": "A4",
            "runners": [
                {
                    "pos": 2,
                    "trap": 1,
                    "runner": "Trickysteddybear",
                    "runner_id": "rn_jhsqwe1z",
                    "trainer": "R Holt",
                    "time": null,
                    "sp": "6/4",
                    "sp_decimal": 2.5
                },
                {
                    "pos": 3,
                    "trap": 2,
                    "runner": "Gurtnacrehy Rhys",
                    "runner_id": "rn_5g4y8zxv",
                    "trainer": "P Webster",
                    "time": null,
                    "sp": "11/4",
                    "sp_decimal": 3.75
                },
                {
                    "pos": 1,
                    "trap": 3,
                    "runner": "Listen Jessie",
                    "runner_id": "rn_xgfvd5nx",
                    "trainer": "K Hodson",
                    "time": null,
                    "sp": "7/1",
                    "sp_decimal": 8
                }
            ]
        }
    ],
    "meta": {
        "count": 50,
        "page": 1,
        "per_page": 50,
        "total": 177,
        "total_pages": 4,
        "next_cursor": "cDI",
        "took_ms": 58
    }
}

Errors

Status	Code	What to do
400	`bad_request`	A value is not valid, a date is before 2020, or the key was put in the address. The message says which.
401	`unauthorized`	No key, or the key is wrong, revoked or expired. Check the header.
403	`upgrade_required`	Your plan does not include this endpoint. `plan` names the one that does.
422	`unknown_parameter`	A parameter this endpoint does not take. The message lists the ones it does.
429	`rate_limited`	Too many calls this minute. Wait for `Retry-After`.
429	`quota_exceeded`	Today's allowance is used. It resets at 00:00 UTC.
503	`server_error`	Our side. Not counted against you. Try again shortly, and see status.

Greyhound racing API: Today's racecards