APIHorseRacing

Documentation / Trainers

Trainer profile

GET /v1/trainers/{trainer_id}

Runs, wins and the horses sent out.

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

NameInTypeRequiredDescription
trainer_id path string yes Opaque trainer identifier.

Request

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

Response

200 OK application/json harvested 8 days ago
{
    "meta": {
        "request_id": "362f4af3e16a955a",
        "data_as_of": "2026-09-12T05:10:27+00:00",
        "plan": "analyst",
        "window": "2017 → upcoming"
    },
    "data": {
        "trainer_id": "tr_2QVAXT3",
        "name": "Ben Clarke",
        "record": {
            "runs": 425,
            "wins": 54,
            "win_pct": 0.1271,
            "horses": 55,
            "first_run": "2017-05-18",
            "last_run": "2026-09-06"
        }
    }
}

A real response from /v1/trainers/tr_2QVAXT3, 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.

FieldTypeWhat it is
trainer_id string Opaque trainer 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

CodeStatusWhen
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.

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

What this is for

One trainer: runners, wins, places, the date span of the record, and the horses sent out, most raced first.

These are counted from the races we hold rather than taken from a source field, so they describe what is in the archive rather than a career. The first and last dates tell you the span the figures cover, which matters for anyone who was training before 2017.

A strike rate is deliberately not the headline here. It is available, but on its own it mostly measures the quality of horse a yard attracts. /v1/trainers/{id}/stats is where the useful version lives.

Common uses

A trainer page

This plus the form endpoint covers it.

Finding a yard's string

The horses list is the roster as it appears in results, which is more current than any published string.

Related in Trainers