Reading an unusual booking
A yard that rarely uses this rider, with a good record when it does.
Documentation / Jockeys & owners
/v1/jockeys/{jockey_id}/trainers
Which yards a rider does well for.
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 |
|---|---|---|---|---|
| jockey_id | path | string | yes | Opaque jockey identifier. |
| min_runs | query | integer | no | Drop yards with fewer rides than this. Defaults to 5. |
curl https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/trainers \ -H "X-API-Key: $AHR_KEY"
$ch = curl_init('https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/trainers'); 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/jockeys/jk_1ABH146/trainers', { 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/jockeys/jk_1ABH146/trainers", headers={"X-API-Key": os.environ["AHR_KEY"]}, ).json()
curl https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/trainers?key=$AHR_KEY
$url = 'https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/trainers' . '?key=$AHR_KEY'; $data = json_decode(file_get_contents($url), true)['data'];
const res = await fetch( 'https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/trainers?key=$AHR_KEY' ); const { meta, data } = await res.json();
import os, requests r = requests.get( "https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/trainers?key=$AHR_KEY", ).json()
{ "meta": { "request_id": "433fe3eb7c19d5f5", "data_as_of": "2026-09-12T05:10:27+00:00", "plan": "analyst", "window": "2017 → upcoming", "count": 77 }, "data": { "jockey_id": "jk_1ABH146", "jockey": "Millie Wonnacott", "window": { "from": null, "to": null, "note": "The whole archive. Your plan sets no date limit." }, "overall": { "runs": 449, "priced": 449, "first": 50, "second": 46, "third": 50, "fourth": 44, "win_pct": 0.1114, "top3_pct": 0.3252, "expected_wins": 39.02, "a_e": 1.281, "a_e_range": [ 0.926, 1.636 ], "a_e_beats_market": false, "significant": false, "low_sample": false, "pl_1pt": 15.89, "roi_pct": 3.54 }, "by": "trainer", "trainer": [ { "trainer": "N P Mulholland", "runs": 111, "priced": 111, "first": 15, "second": 13, "third": 15, "fourth": 10, "win_pct": 0.1351, "top3_pct": 0.3874, "expected_wins": 10.76, "a_e": 1.394, "a_e_range": [ 0.689, 2.1 ], "a_e_beats_market": false, "significant": false, "low_sample": false, "pl_1pt": 3.81, "roi_pct": 3.43 }, { "trainer": "J S Moore", "runs": 48, "priced": 48, "first": 6, "second": 5, "third": 7, "fourth": 7, "win_pct": 0.125, "top3_pct": 0.375, "expected_wins": 4.88, "a_e": 1.23, "a_e_range": [ 0.246, 2.215 ], "a_e_beats_market": false, "significant": false, "low_sample": true, "pl_1pt": -15.38, "roi_pct": -32.03 }, "… 75 more" ] } }
A real response from /v1/jockeys/jk_1ABH146/trainers,
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 |
|---|---|---|
| jockey_id | string | Opaque jockey identifier. |
| jockey | string | Rider 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. |
| trainer | string | Trainer 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 yards a rider does well for, as a full statistics block per trainer.
This is the same pairing as /v1/trainers/{id}/jockeys viewed from the other end, and the two answer different questions. From the trainer's side you are asking which rider gets the best out of these horses. From here you are asking which yards supply this rider with horses that beat their prices.
A retained rider will have one row with almost all the rides in it. The rows worth reading are the outside yards, where a booking was a choice rather than an arrangement.
A yard that rarely uses this rider, with a good record when it does.
Where the rides came from over the archive, and which of those relationships actually paid.