Reading a booking
An unusual rider on a yard's horse is worth checking here before assuming anything.
/v1/trainers/{trainer_id}/jockeys
Which riders have paid for this yard.
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. |
| min_runs | query | integer | no | Drop riders with fewer rides than this. Defaults to 5. |
curl https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/jockeys \ -H "X-API-Key: $AHR_KEY"
$ch = curl_init('https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/jockeys'); 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/jockeys', { 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/jockeys", headers={"X-API-Key": os.environ["AHR_KEY"]}, ).json()
curl https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/jockeys?key=$AHR_KEY
$url = 'https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/jockeys' . '?key=$AHR_KEY'; $data = json_decode(file_get_contents($url), true)['data'];
const res = await fetch( 'https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/jockeys?key=$AHR_KEY' ); const { meta, data } = await res.json();
import os, requests r = requests.get( "https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/jockeys?key=$AHR_KEY", ).json()
{ "meta": { "request_id": "81d066538e48470d", "data_as_of": "2026-09-12T05:10:27+00:00", "plan": "analyst", "window": "2017 → upcoming", "count": 3 }, "data": { "trainer_id": "tr_2QVAXT3", "trainer": "Ben Clarke", "window": { "from": null, "to": null, "note": "The whole archive. Your plan sets no date limit." }, "overall": { "runs": 425, "priced": 425, "first": 54, "second": 63, "third": 59, "fourth": 38, "win_pct": 0.1271, "top3_pct": 0.4141, "expected_wins": 48.39, "a_e": 1.116, "a_e_range": [ 0.818, 1.413 ], "a_e_beats_market": false, "significant": false, "low_sample": false, "pl_1pt": -90.11, "roi_pct": -21.2 }, "by": "jockey", "jockey": [ { "jockey": "Ben Jones", "runs": 163, "priced": 163, "first": 25, "second": 21, "third": 22, "fourth": 16, "win_pct": 0.1534, "top3_pct": 0.4172, "expected_wins": 17, "a_e": 1.471, "a_e_range": [ 0.894, 2.047 ], "a_e_beats_market": false, "significant": false, "low_sample": false, "pl_1pt": 2.73, "roi_pct": 1.68 }, { "jockey": "Rex Dingle", "runs": 46, "priced": 46, "first": 5, "second": 9, "third": 4, "fourth": 6, "win_pct": 0.1087, "top3_pct": 0.3913, "expected_wins": 4.85, "a_e": 1.031, "a_e_range": [ 0.127, 1.935 ], "a_e_beats_market": false, "significant": false, "low_sample": true, "pl_1pt": -19.25, "roi_pct": -41.85 }, "… 1 more" ] } }
A real response from /v1/trainers/tr_2QVAXT3/jockeys?limit=3,
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. |
| trainer | string | Trainer name. |
| window | string | How far back and forward that plan can read. |
| runs | integer | Rides in the slice, priced or not. |
| priced | integer | Rides carrying a starting price. A/E and the profit figures use these; runs is the wider count. |
| first | integer | Wins. |
| second | integer | Seconds. Positions are returned separately so you apply your own place terms. |
| third | integer | Thirds. |
| fourth | integer | Fourths. |
| win_pct | number | Wins over runs. The number everyone quotes and the one that tells you least. |
| top3_pct | number | First, second or third over runs. Not a place strike rate; place terms vary. |
| expected_wins | number | Wins the market implied, summed over the slice. |
| a_e | number | Actual wins over expected. Above 1.00 means winning more often than the prices said. |
| a_e_range | array | Ninety five percent interval on A/E. If it spans 1.00 the figure is not evidence of anything. |
| a_e_beats_market | boolean | True only where the whole interval sits above 1.00. |
| significant | boolean | Whether the interval excludes 1.00 in either direction. |
| low_sample | boolean | Fewer than five expected wins. Treat A/E as noise. |
| pl_1pt | number | One point on every runner, settled at starting price. |
| roi_pct | number | Level stakes return. Backing everything loses more than the book margin, because equal stakes overweight the longshots. |
| jockey | string | Rider name. |
| 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. |
| upgrade_required | 403 | The endpoint returns computed statistics and your plan does not include them. The body names every plan that does reach it, so you never have to look it up. |
| 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. |
| invalid_param | 422 | A date that is not YYYY-MM-DD, a by= dimension we do not have, or a cursor that did not come from us. The message names the parameter. |
| 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
Which riders have actually paid for this yard, as a full statistics block per jockey rather than a bare win count.
The trainer and jockey combination is the most quoted statistic in racing and one of the least examined. A stable jockey rides the best horses in the yard, so a high strike rate is close to guaranteed and says nothing. A/E strips that out: it asks whether the pairing beat its prices, not whether it won.
The interesting rows are usually not the stable jockey. An outside rider booked occasionally, with a high A/E over enough rides, is a booking the market may not be reading correctly.
An unusual rider on a yard's horse is worth checking here before assuming anything.
High A/E, moderate strike rate, enough rides. All three matter.