Documentation / Results
Search races
Results planMCP tool: search_races
Races by date, nation, course, race type, going or surface.
Try itRuns against the real API with your key
No key yet? The free key is made the moment you sign in, and appears here by itself.Get a free key
optional
optional
optional
optional
optional
optional
optional
optional
optional
optional
https://api.horseracingapi.org/v1/races/search?date_from=2026-10-20&date_to=2026-10-20&country=FR&per_page=3
Press Run to see the live answer here.
curl "https://api.horseracingapi.org/v1/races/search?date_from=2026-10-20&date_to=2026-10-20&country=FR&per_page=3" \ -H "X-API-Key: hra_live_…"
Parameters
NameIn · typeRequiredWhat it is
date_fromquery · dateNoFrom this day. The archive starts on 2022-01-01.
date_toquery · dateNoUp to this day. Defaults to today.
countryquery · stringNoOnly this nation: USA, GB, IRE, FR or RSA.USAGBIREFRRSA
course_idquery · stringNoOnly this course.
race_typequery · stringNoFlat, Hurdle, Chase and so on.
goingquery · stringNoThe going, as published.
surfacequery · stringNoTurf, Dirt or All Weather.TurfDirtAll Weather
handicapquery · booleanNotrue for handicaps only, false for none.
per_pagequery · integerNoHow many to a page, 1 to 100. Default 25.
cursorquery · stringNometa.next_cursor from the previous answer, as it came.
Returns
FieldTypeWhat it holds
race_idstringOur own id for the race. Stable, safe to store.
meeting_idstringThe meeting it was run at.
course_idstringThe course.
coursestringWhere it was run.
countrystringUSA, GB, IRE, FR or RSA.
datestringThe course's own calendar day, YYYY-MM-DD.
timestringThe advertised start, course time, HH:MM.
off_timestringWhen it actually started, course time, HH:MM:SS.
namestringThe race title as run.
race_typestringFlat, Hurdle, Chase and so on, where the nation publishes it.
classstringWhere the nation publishes one, else null.
distancestringAs the course states it.
goingstringThe ground as declared on the day.
surfacestringTurf, Dirt or All Weather.
handicapbooleanWhether it was a handicap.
runnersintegerHow many started.
result_availablebooleanTrue once the result is declared.
Example answer
{
"data": [
{
"race_id": "rc_9c9cmvvp",
"meeting_id": "mt_31tcke0x",
"course_id": "cr_t6pv23df",
"course": "Bordeaux Le Bouscat",
"country": "FR",
"date": "2026-10-20",
"time": "09:20",
"off_time": "09:20:42",
"name": "Prix De Suffren Stakes",
"race_type": "Flat",
"class": null,
"distance": "1m 1f 97y",
"going": "Soft",
"surface": "Turf",
"handicap": false,
"runners": 6,
"result_available": true
},
{
"race_id": "rc_52zjchex",
"meeting_id": "mt_31tcke0x",
"course_id": "cr_t6pv23df",
"course": "Bordeaux Le Bouscat",
"country": "FR",
"date": "2026-10-20",
"time": "09:51",
"off_time": "09:51:18",
"name": "Prix Jean Des Roches De Chassay Chase",
"race_type": "Chase",
"class": null,
"distance": "2m 4f 193y",
"going": "Soft",
"surface": "Turf",
"handicap": false,
"runners": 8,
"result_available": true
},
"… 1 more"
],
"meta": {
"plan": "results",
"window": "2022-01-01 to now",
"data_as_of": "2026-10-21T21:19:06Z",
"count": 3,
"next_cursor": "f5EOuMvR7PUuN-sFdPEJiSxj4OIngspRG4i0QxeehqPj35gHQKXqaikPHZ_AtfOCAKxQe72sMjTK"
}
}Errors
StatusCodeWhen