Spotting the good horses in a yard
The owner rows with the best A/E are usually where the money is.
/v1/trainers/{trainer_id}/owners
Split by who owns the horse.
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 owners with fewer runners than this. Defaults to 5. |
curl https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/owners \ -H "X-API-Key: $AHR_KEY"
$ch = curl_init('https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/owners'); 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/owners', { 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/owners", headers={"X-API-Key": os.environ["AHR_KEY"]}, ).json()
curl https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/owners?key=$AHR_KEY
$url = 'https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/owners' . '?key=$AHR_KEY'; $data = json_decode(file_get_contents($url), true)['data'];
const res = await fetch( 'https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/owners?key=$AHR_KEY' ); const { meta, data } = await res.json();
import os, requests r = requests.get( "https://api.apihorseracing.com/v1/trainers/tr_2QVAXT3/owners?key=$AHR_KEY", ).json()
{ "meta": { "request_id": "1705ef2f2ab86a31", "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": "owner", "owner": [ { "owner": "Mr Adrian Paterson", "runs": 62, "priced": 62, "first": 10, "second": 6, "third": 8, "fourth": 4, "win_pct": 0.1613, "top3_pct": 0.3871, "expected_wins": 7.61, "a_e": 1.315, "a_e_range": [ 0.5, 2.129 ], "a_e_beats_market": false, "significant": false, "low_sample": false, "pl_1pt": 8.89, "roi_pct": 14.35 }, { "owner": "Sue & Clive Cole & Ann & Tony Gale", "runs": 35, "priced": 35, "first": 4, "second": 6, "third": 4, "fourth": 4, "win_pct": 0.1143, "top3_pct": 0.4, "expected_wins": 3.49, "a_e": 1.146, "a_e_range": [ 0.023, 2.269 ], "a_e_beats_market": false, "significant": false, "low_sample": true, "pl_1pt": -13.33, "roi_pct": -38.1 }, "… 1 more" ] } }
A real response from /v1/trainers/tr_2QVAXT3/owners?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. |
| owner | string | Registered owner as published. |
| 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
The yard split by who owns the horse. A proxy for something the data does not record directly: which horses in a yard are the expensive ones.
A large owner's horses in a mixed yard are usually its best, and they are often priced as such. Where they are not, the A/E shows it.
Owners are identified by name here, because the source publishes no owner identifier at all. Syndicates and partnerships appear as they are written, and the same people under two forms of a name are two owners to us. This endpoint is a shape to explore rather than a clean dimension.
The owner rows with the best A/E are usually where the money is.
A first-time runner in familiar colours at a yard is more informative than the horse's own record, which is empty.
Fewer owners are named than horses run. Where the source published none the runner is excluded from this breakdown rather than bucketed as unknown.