APIHorseRacing

Free key Register

Docs Coverage Pricing Labs Status Support

Free key Register

API reference

Documentation

63 REST endpoints over horse racing in eleven jurisdictions: racecards, results, starting prices, price movement, book percentages, horses, trainers, jockeys, owners and courses. Race data only. No predictions, no ratings, no betting advice.

63REST endpoints

37On the free key

24Analyst only

9Paginated

Machine readable: OpenAPI 3.1 · Postman collection · Changelog. Both are generated from the same registry as these pages, so a client you generate cannot describe an endpoint that does not exist. Every endpoint page has a Run it live console; bring your key.

Quickstart

Base URL https://api.apihorseracing.com, your key in the X-API-Key header, JSON back in a meta and data envelope. This is the whole of it:

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

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

New here? Read Getting started, then Coverage by country and Errors. Those three are the difference between a call that works and an integration that behaves.

Guides

22

Read these before the reference. They answer the questions the reference assumes you already know.

Start here3

01 Getting started From nothing to a working request in about two minutes. Read 02 Authentication One key, two ways to send it, and what a refusal looks like. Read 03 Your first four calls What is running, one race, yesterday read back, and a real question. Read

Coverage & integrity4

04 Coverage by country Which jurisdictions publish what, counted rather than claimed. Read 05 What a race carries Forty four fields, in the order they become known. Read 06 Identifiers Why ids look the way they do, and why they are safe to store. Read 07 Data freshness What data_as_of means and when the archive moves. Read

Reading a response5

08 The envelope meta and data, and what is always in meta. Read 09 Pagination Cursors, not offsets, and why that matters mid-sync. Read 10 Errors Every code, what causes it, and what to do about it. Read 11 Timezones and dates Everything is UTC except a race time, which is local to the course. Read 12 Prices and price movement Fractional, decimal, opening, touched, and what source tells you. Read

Statistics3

13 Understanding A/E The number the Analyst tier exists for, and how to read its interval. Read 14 Level stakes and return Why backing everything loses more than the book margin. Read 15 Breakdown dimensions Seventeen ways to slice the same block. Read

Limits & delivery7

16 Rate limits and quotas Per minute, per month, and the headers that tell you. Read 17 Race reports A written account of every race, and the one line per runner behind it. Read 18 OpenAPI spec Generate a client, or import the whole API into your tooling. Read 19 Postman collection Import it, set one variable, and every request is ready to send. Read 20 Using it from an assistant Connect Claude, ChatGPT or any MCP client and ask in plain English. Read 21 Webhooks Four events, signed deliveries, and no quota cost. Read 22 Bulk and backfilling How to walk nine years without being refused. Read

CHANGELOG Price movement on every runner 9 September 2026 · 8 entries, newest first Read the changelog

/ 63 endpoints

Reference & coverage 7 Race reports 2 Racecards & meetings 7 Races & markets 7 Horses & pedigree 8 Trainers 7 Jockeys & owners 10 Webhooks & account 3 Courses & bias 6 Market & analysis 6

Reference & coverage

7

What exists, and how much of it. Call these before writing anything else.

GET /v1/countries Jurisdictions Every country in the archive with its race count and which fields it publishes. GET /v1/courses Courses Every course, with first and last meeting and how many races we hold. GET /v1/meta/coverage Coverage Totals, the full-order split, and what your own plan can read. GET /v1/search Search everything One lookup across horses, trainers, jockeys and courses. GET /v1/courses/{course_id} Course profile Run types, surfaces and distances actually raced there. GET /v1/reference Filter values Valid goings, classes and run types, counted from the data. GET /v1/meta/reports Report coverage How many race reports exist, from when, and for which jurisdictions.

Race reports

2

A written account of every race, from the records themselves.

GET /v1/reports Find reports Search written race reports by date, course or jurisdiction. GET /v1/reports/{race_id} Race report The written account of a single race, with a line for every runner.

Racecards & meetings

7

Today, tomorrow, and any day in the archive.

GET /v1/racecards/today Today's cards Every meeting and race today, grouped by course. Live window GET /v1/racecards/upcoming Upcoming Declarations for the next few days. Live window GET /v1/meetings/{date} Meetings by date One row per course on that day, with going and race count. GET /v1/results/latest Latest results The most recently settled races your plan can read. Live window GET /v1/racecards/{date} Card by date The full card for any date, grouped into meetings. GET /v1/meetings/{meeting_id} Meeting card A meeting and every race on it. GET /v1/results/{date} Results by date Settled races for a date, grouped into meetings.

Races & markets

7

One race, in as much detail as exists.

GET /v1/races/search Search races Filter by date, region, run type, going, class, field size. Cursor paginated. Paged GET /v1/races/{race_id}/result Finishing order Finishing order, casualties, dividends and prize money. GET /v1/races/{race_id}/market Market Book percentage, every price, and what moved before the off. GET /v1/races/{race_id}/dividends Dividends Tote returns and prizes, where the jurisdiction published them. GET /v1/races/{race_id} Race detail Conditions, the market, and every runner with its price and position. GET /v1/races/{race_id}/runners Field and runners The field alone, without the race conditions. GET /v1/races/{race_id}/analysis Race in context Market shape, movers, and what this course and distance usually produces.

Horses & pedigree

8

Form, breeding, and whether a horse is improving.

GET /v1/horses/{horse_id}/form Form line Recent runs, newest first, clipped to your window. Paged GET /v1/horses/{horse_id}/pedigree Breeding Sire, dam and damsire, plus others by the same sire. GET /v1/horses/{horse_id}/layoff After a break Performance split by days since the last run. Analyst GET /v1/horses/compare Head to head Every race these horses have both run in, and who finished ahead. GET /v1/horses/search Search horses By name, with career totals attached. Paged GET /v1/horses/{horse_id} Horse profile Career record and breeding where it has been fetched. GET /v1/horses/{horse_id}/trend Form trend Each run measured against what the market expected of it. Analyst GET /v1/horses/{horse_id}/stats Statistics The standard block, sliceable seventeen ways. Analyst

Trainers

7

A yard, and how it has actually paid.

GET /v1/trainers/search Search trainers By name. Paged GET /v1/trainers/{trainer_id}/form Recent runners Newest first, with the price and the finish. Paged GET /v1/trainers/{trainer_id}/jockeys By jockey Which riders have paid for this yard. Analyst GET /v1/trainers/{trainer_id}/courses By course The slice that finds where a yard actually wins. Analyst GET /v1/trainers/{trainer_id} Trainer profile Runs, wins and the horses sent out. GET /v1/trainers/{trainer_id}/stats Statistics Strike rate, A/E and level stakes, by any dimension. Analyst GET /v1/trainers/{trainer_id}/owners By owner Split by who owns the horse. Analyst

Jockeys & owners

10

The same shapes as trainers, deliberately.

GET /v1/jockeys/{jockey_id}/form Recent rides Newest first. Paged GET /v1/jockeys/{jockey_id}/trainers By trainer Which yards a rider does well for. Analyst GET /v1/owners/{owner_id}/jockeys By jockey Riders used, and how they paid. Analyst GET /v1/owners/{owner_id}/courses By course Where the colours have done well. Analyst GET /v1/jockeys/search Search jockeys By name. Paged GET /v1/jockeys/{jockey_id} Jockey profile Rides, wins and the span of them. GET /v1/jockeys/{jockey_id}/stats Statistics The standard block for a rider. Analyst GET /v1/owners/search Search owners By name. Owners are identified by name; the source publishes no id. Paged GET /v1/owners/{owner_id} Owner profile Runs, wins and horses. GET /v1/owners/{owner_id}/stats Statistics The standard block for an owner. Analyst

Webhooks & account

3

Being told, instead of asking.

POST /v1/webhooks/subscribe Subscribe Point a URL at an event and we sign every delivery. GET /v1/webhooks/deliveries Deliveries What we sent, when, and whether it landed. Paged GET /v1/account/usage Your usage Requests, errors and every refusal, by endpoint.

Courses & bias

6

What a track does to a race.

GET /v1/courses/{course_id}/draw-bias Draw bias Low, middle and high thirds of the field, per distance. Analyst GET /v1/courses/{course_id}/standard-times Standard times Median winning time per distance, with the implausible ones counted. Analyst GET /v1/courses/{course_id}/favourites Favourites How the market leader holds up here. Analyst GET /v1/courses/{course_id}/casualties Casualties Non-completion rates by run type. Analyst GET /v1/courses/{course_id}/stats Course statistics The standard block for everything run there. Analyst GET /v1/courses/{course_id}/going-record By going How the ground changes what wins. Analyst

Market & analysis

6

The market itself, across the whole archive.

GET /v1/market/sp-performance Price performance What each price band has actually returned. Analyst GET /v1/market/movers Market movers Whether money moving tells you anything. Analyst GET /v1/market/overround Book percentage How fat the books have been, by field size and course. Analyst GET /v1/analysis/angles Ask your own question Every filter combined freely, returning the standard block. Analyst GET /v1/analysis/layoff Days since last run Performance by days since the last run, across everything. Analyst GET /v1/analysis/precedents Precedents Races that ran under matching conditions. Analyst