APIHorseRacing

Documentation / Jockeys & owners

Statistics

GET /v1/jockeys/{jockey_id}/stats

The standard block for a rider.

Available on

Free key not on this plan
Live not on this plan
Archive not on this plan
Complete not on this plan
Complete + Analyst 2017 → upcoming

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.

Parameters

NameInTypeRequiredDescription
jockey_id path string yes Opaque jockey identifier.
by query string no A breakdown dimension: course, region, run_type, distance, going, surface, class, year, month, draw, field_size, layoff, sp_band, trainer, owner or sire. Omit for the overall block.
min_runs query integer no Drop breakdown rows with fewer rides than this. Defaults to 1; 30 is a more useful floor for anything you intend to act on.
date_from query string no YYYY-MM-DD. Clamped to your plan's window.
date_to query string no YYYY-MM-DD. Clamped to your plan's window.

Request

curl https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats \
  -H "X-API-Key: $AHR_KEY"

Response

200 OK application/json harvested 8 days ago
{
    "meta": {
        "request_id": "c45b629a09627222",
        "data_as_of": "2026-09-12T05:10:27+00:00",
        "plan": "analyst",
        "window": "2017 → upcoming",
        "count": 3
    },
    "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": "course",
        "course": [
            {
                "course": "Wolverhampton",
                "runs": 58,
                "priced": 58,
                "first": 6,
                "second": 2,
                "third": 5,
                "fourth": 7,
                "win_pct": 0.1034,
                "top3_pct": 0.2241,
                "expected_wins": 4.57,
                "a_e": 1.313,
                "a_e_range": [
                    0.262,
                    2.363
                ],
                "a_e_beats_market": false,
                "significant": false,
                "low_sample": true,
                "pl_1pt": 9,
                "roi_pct": 15.52
            },
            {
                "course": "Bath",
                "runs": 43,
                "priced": 43,
                "first": 5,
                "second": 8,
                "third": 3,
                "fourth": 1,
                "win_pct": 0.1163,
                "top3_pct": 0.3721,
                "expected_wins": 3.79,
                "a_e": 1.318,
                "a_e_range": [
                    0.163,
                    2.473
                ],
                "a_e_beats_market": false,
                "significant": false,
                "low_sample": true,
                "pl_1pt": 25,
                "roi_pct": 58.14
            },
            "… 1 more"
        ]
    }
}

A real response from /v1/jockeys/jk_1ABH146/stats?by=course&limit=3, captured by calling the live API rather than written by hand.

Response fields

Each field is described once and rendered on every endpoint that returns it, so the wording cannot drift between pages.

FieldTypeWhat 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.
course string Course name.

Errors this endpoint returns

CodeStatusWhen
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.

Run it live

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.

What this is for

The standard statistics block for a rider, split any of sixteen ways, each row with a confidence interval.

A/E matters more for jockeys than for anyone else in this API, because a jockey's strike rate is almost entirely a function of the horses he is put on. A/E asks whether the rides beat their prices, which is the only version of the question that is about the rider at all.

Even then, be careful about what you conclude. A high A/E over a career is more likely to mean a rider is systematically underrated by the market than that he is better than everyone thinks. Those are different claims, and only the first is about prices.

The two dimensions worth reaching for first are by=course, because riders genuinely ride some tracks better, and by=run_type, because a flat jockey and a jumps jockey are different professions and a few people do both.

Common uses

Judging a claimer

A claiming rider carries a weight allowance, so a positive A/E may be the allowance rather than the rider. by=year over the period the claim reduced shows which.

Finding a course specialist

by=course with min_runs=30. Big galloping tracks and tight turning ones reward different riding.

Separating the rider from the yard

by=trainer. If every good row is one yard, you are looking at the yard.

Notes

by=jockey is rejected with invalid_param here rather than silently ignored.

Related in Jockeys & owners