Latest results

GET /v1/results/latest

The most recently settled races your plan can read.

Available on

Free key 24h – 7d

Live today + 3 days

Archive back to 2017

Complete 2017 → upcoming

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

Name	In	Type	Required	Description
limit	query	integer	no	1 to 100. Defaults to 25.

Request

curl https://api.apihorseracing.com/v1/results/latest \
  -H "X-API-Key: $AHR_KEY"

$ch = curl_init('https://api.apihorseracing.com/v1/results/latest');
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/results/latest',
  { 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/results/latest",
    headers={"X-API-Key": os.environ["AHR_KEY"]},
).json()

Response

200 OK application/json harvested 8 days ago

{
    "meta": {
        "request_id": "2227a51eb1914bfa",
        "data_as_of": "2026-09-12T05:10:27+00:00",
        "plan": "analyst",
        "window": "2017 → upcoming",
        "count": 3
    },
    "data": [
        {
            "race_id": "rc_90ZE4F",
            "meeting_id": "mt_2Y62RYP",
            "course": "Emerald Downs",
            "time": "23:57",
            "off_time": "23:58:40",
            "name": "Race 7 - Muckleshoot Juvenile Filly Stakes",
            "run_type": null,
            "class": null,
            "distance": "6f 110y",
            "going": "Fast",
            "surface": "DIRT",
            "handicap": false,
            "runners": 6,
            "result_available": true,
            "date": "2026-09-06",
            "winning_time": "1m 17.75s",
            "book_percentage": 120.56
        },
        {
            "race_id": "rc_S1CARS",
            "meeting_id": "mt_1ZZ0ZVG",
            "course": "Mountaineer",
            "time": "23:50",
            "off_time": "23:56:27",
            "name": "Race 3 - Starter Allowance",
            "run_type": null,
            "class": null,
            "distance": "1m",
            "going": "Fast",
            "surface": "TURF",
            "handicap": false,
            "runners": 10,
            "result_available": true,
            "date": "2026-09-06",
            "winning_time": "1m 41.98s",
            "book_percentage": 124.2
        },
        "… 1 more"
    ]
}

A real response from /v1/results/latest?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.

Field	Type	What it is
race_id	string	Opaque race identifier. Stable, and safe to store.
meeting_id	string	Opaque meeting identifier. A meeting is one course on one day.
course	string	Course name.
time	string	Scheduled off time, local to the course.
off_time	string	Actual off time where recorded.
name	string	Race title as published, sponsor and all.
run_type	string	Flat, Hurdle, Chase or NH Flat.
class	string	Race class.
distance	string	Official distance as published, e.g. "3m 3f 119y".
going	string	Ground description at the off.
surface	string	Turf, Dirt, Polytrack and so on.
handicap	boolean	Whether the race was run off official ratings.
runners	integer	Runners who took part.
result_available	boolean	Whether a result has been published.
date	date	Race date, YYYY-MM-DD.
winning_time	string	Winning time as published.
book_percentage	number	The field's implied probabilities added up. 100 would be a fair book; the excess is the margin. Ours average 117 in small fields and 133 in sixteen or more.

What varies by jurisdiction

Run type is filled in behind the results crawl

The code a race was run under lives on the horse profile rather than the race, so it arrives on a later pass. A null run_type means not yet fetched, not unclassified.

Race class is a British idea

Class is published in Britain and reliably absent elsewhere. Do not treat a null class as an ungraded race.

Winning times are patchy outside Britain and Ireland

Where a time exists it is as published. /v1/courses/{id}/standard-times reports the median per distance and counts the implausible ones rather than quietly serving them.

Errors this endpoint returns

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

Your API key

Remembered in this browser so you do not paste it on every page.

limit optional

What this is for

The most recently settled races your plan can read, newest first, with the winning time and the book percentage attached.

The phrase "your plan can read" is doing real work. On a free key latest means the newest race inside the delayed window, not the newest race in the archive followed by a refusal. The endpoint gives you the best answer available to you rather than an error.

Common uses

A live results ticker

Poll at a sensible interval with a small limit. A webhook is better if you can take one, because it costs nothing against your quota and arrives sooner.

Confirming the pipeline is moving

If the newest result stops advancing during a racing afternoon, something is wrong upstream. /status says whether it is us.

Notes

Ordered by race date and off time, not by when we loaded it. A late-settling race can therefore appear below one that ran after it.