Horse profile

GET /v1/horses/{horse_id}

Career record and breeding where it has been fetched.

Available on

Free key 24h – 7d

Live today + 3 days

Archive back to 2017

Complete 2017 → upcoming

Complete + Analyst 2017 → upcoming

Send your key in the X-API-Key header, or as ?key= if your tool cannot set one. A date outside your plan's window returns 403 outside_window naming the window, never an empty array.

Parameters

Name	In	Type	Required	Description
horse_id	path	string	yes	Opaque horse identifier.

Request

curl https://api.apihorseracing.com/v1/horses/hs_V8JGH6 \
  -H "X-API-Key: $AHR_KEY"

$ch = curl_init('https://api.apihorseracing.com/v1/horses/hs_V8JGH6');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: ' . getenv('AHR_KEY')],
]);
$data = json_decode(curl_exec($ch), true)['data'];

const res = await fetch(
  'https://api.apihorseracing.com/v1/horses/hs_V8JGH6',
  { headers: { 'X-API-Key': process.env.AHR_KEY } }
);
const { meta, data } = await res.json();

import os, requests

r = requests.get(
    "https://api.apihorseracing.com/v1/horses/hs_V8JGH6",
    headers={"X-API-Key": os.environ["AHR_KEY"]},
).json()

Response

200 OK application/json harvested 8 days ago

{
    "meta": {
        "request_id": "f103ea16bc7975a9",
        "data_as_of": "2026-09-12T05:10:27+00:00",
        "plan": "analyst",
        "window": "2017 → upcoming"
    },
    "data": {
        "horse_id": "hs_V8JGH6",
        "name": "The Galloping Bear",
        "sex": "g",
        "colour": null,
        "career": {
            "runs": 18,
            "wins": 4,
            "seconds": 2,
            "thirds": 1,
            "casualties": 6,
            "win_pct": 0.222,
            "first_run": "2019-04-16",
            "last_run": "2024-04-07"
        },
        "pedigree": {
            "sire": null,
            "dam": null,
            "damsire": null,
            "status": "pending"
        }
    }
}

A real response from /v1/horses/hs_V8JGH6, captured by calling the live API rather than written by hand.

Response fields

Each field is described once and rendered on every endpoint that returns it, so the wording cannot drift between pages.

Field	Type	What it is
horse_id	string	Opaque horse identifier.
name	string	Race title as published, sponsor and all.
runs	integer	Rides in the slice, priced or not.
win_pct	number	Wins over runs. The number everyone quotes and the one that tells you least.

Errors this endpoint returns

Code	Status	When
unauthorized	401	No key, or one we do not recognise. Check the header name and that the key has not been rotated from your account page.
not_found	404	The identifier is well formed but nothing has it. Distinct from invalid_id, which means the identifier itself is wrong.
invalid_id	422	The prefix does not match the kind of thing the path expects, or the identifier is malformed. A horse id passed where a race is wanted lands here rather than returning the wrong race.
rate_limited	429	Past your per-minute rate. Retry-After is set, and X-RateLimit-Remaining tells you where you stand on every successful response too.
server_error	500	Ours, not yours. Every response carries a request_id; quote it and we can find the exact request.

Run it live

A real request from your browser straight to api.apihorseracing.com with your own key. Nothing is proxied and nothing is logged by this page.

Your API key

Remembered in this browser so you do not paste it on every page.

horse_id

What this is for

One horse: its career record, its connections, and its breeding where the pedigree pass has reached it.

The career figures are counted from the races we hold rather than taken from a source field, which means they are honest about what the archive contains rather than about the horse's whole life. A horse that raced before 2017 will show fewer runs here than it actually had, and the first and last run dates tell you the span the numbers cover.

Sire and dam arrive on a second pass behind the results crawl, because breeding lives on the horse profile rather than on a race. A null there means not yet fetched, not unknown.

Common uses

A horse page

This plus the form endpoint is the whole thing.

Filtering by experience

Runs and wins are here without needing to walk the form. A first-time runner and a forty-race handicapper are one field apart.