HORSERACINGAPI --:--:-- UTC Sign inFree key

Documentation / Horses

Horse profile

A horse's profile, its current trainer and owner, and its record since 2022.

GET/v1/horses/{horse_id}
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/horses/hs_yrjp3fkv

Press Run to see the live answer here.

curl "https://api.horseracingapi.org/v1/horses/hs_yrjp3fkv" \
  -H "X-API-Key: hra_live_…"

Parameters

NameIn · typeRequiredWhat it is
horse_idpath · stringYesThe horse.

Returns

FieldTypeWhat it holds
horse_idstringOur own id for the horse.
namestringThe name it races under.
sexstringAs published.
colourstringAs published, where it is.
trainer_idstringThe trainer at its latest run.
trainerstringThe trainer name.
owner_idstringThe owner at its latest run.
ownerstringThe owners named in full, exactly as they race.
recordobjectSince the archive starts, in our five nations: runs, wins, seconds, thirds, placed, win_pct, since, last_run.

Example answer

{
  "data": {
    "horse_id": "hs_yrjp3fkv",
    "name": "Drumard",
    "sex": "c",
    "colour": "bay",
    "trainer_id": "tr_aawg032s",
    "trainer": "E Libaud",
    "owner_id": "ow_8d2tqgw5",
    "owner": "Hyperion Sarl",
    "record": {
      "runs": 24,
      "wins": 7,
      "seconds": 4,
      "thirds": 3,
      "placed": 14,
      "win_pct": 0.292,
      "since": "2023-12-03",
      "last_run": "2026-10-20"
    }
  },
  "meta": {
    "plan": "results",
    "window": "2022-01-01 to now",
    "data_as_of": "2026-10-21T21:19:06Z"
  }
}

Errors

StatusCodeWhen
400bad_requestA value is the wrong shape, or the key was sent in the address.
401unauthorizedNo key, or one we do not know.
403upgrade_requiredYour plan does not open this endpoint. It is on the Results plan.
404not_foundNo record has that id.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedOver your calls a minute. Retry after the seconds given.
429quota_exceededYour allowance is used. The answer says when it comes back.
503server_errorOn our side. Try again in a minute.