A trainer page
This plus the form endpoint covers it.
/v1/trainers/{trainer_id}
Runs, wins and the horses sent out.
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.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| trainer_id | path | string | yes | Opaque trainer identifier. |
curl https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3 \ -H "X-API-Key: $AHR_KEY"
$ch = curl_init('https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3'); 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/trainers/tr_2QVAXT3', { 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/trainers/tr_2QVAXT3", headers={"X-API-Key": os.environ["AHR_KEY"]}, ).json()
curl https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3?key=$AHR_KEY
$url = 'https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3' . '?key=$AHR_KEY'; $data = json_decode(file_get_contents($url), true)['data'];
const res = await fetch( 'https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3?key=$AHR_KEY' ); const { meta, data } = await res.json();
import os, requests r = requests.get( "https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3?key=$AHR_KEY", ).json()
{ "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.
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 |
|---|---|---|
| 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. |
| 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. |
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. Forget it
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.
This plus the form endpoint covers it.
The horses list is the roster as it appears in results, which is more current than any published string.