Documentation / Reference
Course
Results plan
One course: its surfaces, race types and distances.
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
required
https://api.horseracingapi.org/v1/courses/cr_t6pv23df
Press Run to see the live answer here.
curl "https://api.horseracingapi.org/v1/courses/cr_t6pv23df" \ -H "X-API-Key: hra_live_…"
Parameters
NameIn · typeRequiredWhat it is
course_idpath · stringYesThe course.
Returns
FieldTypeWhat it holds
course_idstringOur own id for the course.
namestringThe course.
countrystringUSA, GB, IRE, FR or RSA.
surfacesarrayTurf, Dirt or All Weather, as raced on since 2022.
race_typesarrayThe race types run there since 2022, where published.
distancesarrayThe distances it races over, most used first.
last_meetingstringThe day it last raced.
Example answer
{
"data": {
"course_id": "cr_t6pv23df",
"name": "Bordeaux Le Bouscat",
"country": "FR",
"surfaces": [
"Turf"
],
"race_types": [
"Flat",
"Trot",
"Hurdle",
"… 1 more"
],
"distances": [
"1m 5f 38y",
"1m 1f 97y",
"7f 209y",
"… 14 more"
],
"last_meeting": "2026-10-20"
},
"meta": {
"plan": "results",
"window": "2022-01-01 to now",
"data_as_of": "2026-10-21T21:19:06Z"
}
}Errors
StatusCodeWhen