Documentation / Reference
Nations
Free key
The five nations and what each one publishes.
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
https://api.horseracingapi.org/v1/countries
Press Run to see the live answer here.
curl "https://api.horseracingapi.org/v1/countries" \ -H "X-API-Key: hra_live_…"
Returns
FieldTypeWhat it holds
countrystringUSA, GB, IRE, FR or RSA.
namestringThe nation.
notestringAnything worth knowing, else null.
fromstringThe first day served: 2022-01-01.
publishesobjectfinishing_order, class and winning_time: true where the nation publishes them.
Example answer
{
"data": [
{
"country": "USA",
"name": "United States",
"note": null,
"from": "2022-01-01",
"publishes": {
"finishing_order": true,
"class": false,
"winning_time": true
}
},
{
"country": "GB",
"name": "Great Britain",
"note": null,
"from": "2022-01-01",
"publishes": {
"finishing_order": true,
"class": true,
"winning_time": true
}
},
"… 3 more"
],
"meta": {
"plan": "free",
"window": "yesterday",
"data_as_of": "2026-10-21T21:19:06Z",
"count": 5
}
}Errors
StatusCodeWhen