Today's UK racecards
Live, Archive and CompleteMCP: todays_racecards
Today's UK cards, grouped by meeting. British and Northern Irish racing only.
Examplea real answer from 2026-10-29, trimmed to a few rows
{
"data": [
{
"meeting_id": "mt_e6gdvcan",
"course_id": "cr_m5cvpetc",
"course": "Down Royal",
"country": "Nort",
"region": "NIR",
"date": "2026-10-30",
"going": "Yielding",
"surface": "TURF",
"races": [
{
"race_id": "rc_2drzxxqn",
"meeting_id": "mt_e6gdvcan",
"course": "Down Royal",
"time": "13:00",
"off_time": null,
"name": "Irish Stallion Farms EBF Maiden Hurdle",
"run_type": null,
"class": null,
"distance": "2m 6f 110y",
"going": "Yielding",
"surface": "TURF",
"handicap": false,
"runners": 11,
"result_available": false
},
{
"race_id": "rc_tq45xw2w",
"meeting_id": "mt_e6gdvcan",
"course": "Down Royal",
"time": "13:30",
"off_time": null,
"name": "Eventsec Handicap Hurdle (0-100)",
"run_type": null,
"class": null,
"distance": "3m 45y",
"going": "Yielding",
"surface": "TURF",
"handicap": true,
"runners": 23,
"result_available": false
},
{
"race_id": "rc_97we86jg",
"meeting_id": "mt_e6gdvcan",
"course": "Down Royal",
"time": "14:00",
"off_time": null,
"name": "Irish Stallion Farms EBF Feathard Lady Mares Novice Hurdle (Grade 3)",
"run_type": null,
"class": "1",
"distance": "2m 190y",
"going": "Yielding",
"surface": "TURF",
"handicap": false,
"runners": 9,
"result_available": false
}
]
},
{
"meeting_id": "mt_27reay5r",
"course_id": "cr_xtryzmdd",
"course": "Newcastle",
"country": "ENG",
"region": "GB",
"date": "2026-10-30",
"going": "Standard",
"surface": "ALLWEATHER",
"races": [
{
"race_id": "rc_jnae42nn",
"meeting_id": "mt_27reay5r",
"course": "Newcastle",
"time": "16:15",
"off_time": null,
"name": "Midnite: Built For 2026 Not 2006 Handicap",
"run_type": null,
"class": "6",
"distance": "1m 2f 42y",
"going": "Standard",
"surface": "ALLWEATHER",
"handicap": true,
"runners": 14,
"result_available": false
},
{
"race_id": "rc_385jyvxh",
"meeting_id": "mt_27reay5r",
"course": "Newcastle",
"time": "16:45",
"off_time": null,
"name": "All-Weather Championship Is Back Novice Stakes (GBB Race)",
"run_type": null,
"class": "4",
"distance": "7f 14y",
"going": "Standard",
"surface": "ALLWEATHER",
"handicap": false,
"runners": 10,
"result_available": false
},
{
"race_id": "rc_jxnrpja3",
"meeting_id": "mt_27reay5r",
"course": "Newcastle",
"time": "17:15",
"off_time": null,
"name": "AWC Finals Day At Newcastle 26th March Nursery",
"run_type": null,
"class": "5",
"distance": "1m 5y",
"going": "Standard",
"surface": "ALLWEATHER",
"handicap": true,
"runners": 5,
"result_available": false
}
]
}
],
"meta": {
"request_id": "05ff65a232f7aef7",
"plan": "complete",
"window": "January 2017 to the next 3 days",
"data_as_of": "2026-10-30T11:14:03+00:00",
"count": 5
}
}Parameters
| Name | In | Type | Required | What it does |
|---|---|---|---|---|
course | query | course id | no | Only this course's meeting. Course ids come from GET /v1/courses. |
Returns
A list in data, one row each, with meta.count. Every answer carries meta: request_id, plan, window and data_as_of.
| Field | Type | Holds |
|---|---|---|
meeting_id | string | Our id for the meeting. |
course_id | string | Our id for the course. |
course | string | The course name. |
country | string | ENG, Scot, Wale or Nort. |
region | string | GB, or NORT for Northern Ireland. |
date | string | The UK racing day, YYYY-MM-DD. |
going | string | The going as declared; null until it is. |
surface | string | Turf or the all-weather surface. |
races | array | The races, or how many there have been. |
races[].race_id | string | Our id for the race. |
races[].meeting_id | string | Our id for the meeting. |
races[].course | string | The course name. |
races[].time | string | The advertised off time by the racecourse clock, HH:MM. |
races[].off_time | null or value | When the race actually went off, by the racecourse clock; null until it has. |
races[].name | string | The name, as raced: the race title on a race. |
races[].run_type | null or value | Flat, Hurdle, Chase or NH Flat. |
races[].class | null or value | The race class. |
races[].distance | string | The race distance as published, for example 2m 87y. |
races[].going | string | The going as declared; null until it is. |
races[].surface | string | Turf or the all-weather surface. |
races[].handicap | boolean | Whether the race is a handicap. |
races[].runners | integer | The runners, or how many there were. |
races[].result_available | boolean | Whether the race is settled. |
Errors
| Code | Status | When |
|---|---|---|
unauthorized | 401 | No key was sent, or the key is not one of ours. |
upgrade_required | 403 | Your plan does not reach this endpoint. The answer names the plans that do. |
outside_plan_window | 403 | The day asked for is outside what your plan reads. The answer gives your window and the day you asked for. |
bad_request | 400 | A value is the wrong shape: a date that is not YYYY-MM-DD, a cursor that is not ours, or a key sent in the address. |
unknown_parameter | 422 | A parameter this endpoint does not take. The answer lists the ones it does. |
not_found | 404 | No record has that id, or it is not British or Northern Irish racing. |
rate_limited | 429 | Too many calls this minute for your plan. |
quota_exceeded | 429 | Your plan's calls for the month are used. The answer says when they reset. |