Resolving a name to an identifier
The first step before any of the statistics endpoints.
Documentation / Jockeys & owners
/v1/jockeys/search
By name.
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 |
|---|---|---|---|---|
| q | query | string | yes | At least two characters, matched against the name. |
| limit | query | integer | no | 1 to 100. Defaults to 25. |
| cursor | query | string | no | Opaque. Pass next_cursor from the previous response. |
curl https://api.apihorseracing.com/v1/jockeys/search \ -H "X-API-Key: $AHR_KEY"
$ch = curl_init('https://api.apihorseracing.com/v1/jockeys/search'); 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/search', { 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/search", headers={"X-API-Key": os.environ["AHR_KEY"]}, ).json()
curl https://api.apihorseracing.com/v1/jockeys/search?key=$AHR_KEY
$url = 'https://api.apihorseracing.com/v1/jockeys/search' . '?key=$AHR_KEY'; $data = json_decode(file_get_contents($url), true)['data'];
const res = await fetch( 'https://api.apihorseracing.com/v1/jockeys/search?key=$AHR_KEY' ); const { meta, data } = await res.json();
import os, requests r = requests.get( "https://api.apihorseracing.com/v1/jockeys/search?key=$AHR_KEY", ).json()
{ "meta": { "request_id": "5d472ec732cc4d06", "data_as_of": "2026-09-12T05:10:27+00:00", "plan": "analyst", "window": "2017 → upcoming", "query": "Murphy", "count": 25 }, "data": [ { "jockey_id": "jk_TTQ9CD", "name": "Abbie Murphy" }, { "jockey_id": "jk_2VBG9CG", "name": "Aimee Murphy" }, "… 23 more" ] }
A real response from /v1/jockeys/search?name=Murphy,
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. |
| name | string | Race title as published, sponsor and all. |
| 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. |
| 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
Jockeys by name, with rides, wins and the span of the record attached.
Names arrive as published, which for jockeys means initials, and occasionally a claimer marked in the name itself. Two spellings of the same rider are two riders to us; merging them on a fuzzy match would silently combine two records.
The first step before any of the statistics endpoints.
Riders in the same family share surnames constantly. The ride counts and date spans separate them.