Documentation / Horses
Search horses
Results planMCP tool: find_horse
Find a horse by name.
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
optional
optional
https://api.horseracingapi.org/v1/horses/search?q=Druma
Press Run to see the live answer here.
curl "https://api.horseracingapi.org/v1/horses/search?q=Druma" \ -H "X-API-Key: hra_live_…"
Parameters
NameIn · typeRequiredWhat it is
qquery · stringYesPart of the name, two letters or more.
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
horse_idstringOur own id for the horse.
namestringThe name it races under.
sexstringAs published.
last_runstringThe day it last ran.
Example answer
{
"data": [
{
"horse_id": "hs_s8vyb06e",
"name": "Drumadeise",
"sex": "m",
"last_run": "2026-10-05"
},
{
"horse_id": "hs_wja7ehed",
"name": "Drumadoon",
"sex": "h",
"last_run": "2024-07-06"
},
"… 2 more"
],
"meta": {
"plan": "results",
"window": "2022-01-01 to now",
"data_as_of": "2026-10-21T21:19:06Z",
"count": 4,
"next_cursor": null
}
}Errors
StatusCodeWhen