Meeting card

GET /v1/meetings/{meeting_id}

A meeting and every race on it.

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
meeting_id	path	string	yes	Opaque meeting identifier, as returned by /v1/meetings/{date} or on any race.

Request

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

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

Response

200 OK application/json harvested 8 days ago

{
    "meta": {
        "request_id": "536c169b32cf9699",
        "data_as_of": "2026-09-12T05:10:27+00:00",
        "plan": "analyst",
        "window": "2017 → upcoming"
    },
    "data": {
        "meeting_id": "mt_3NKDYYE",
        "course_id": "cr_JSRC8Z",
        "course": "Fontwell",
        "country": "ENG",
        "region": "GB",
        "date": "2021-02-28",
        "going": "Good to Soft (Soft in places)",
        "surface": "Turf",
        "weather": "Fine & Dry",
        "status": "DORMANT",
        "races": [
            {
                "race_id": "rc_1XJN2C8",
                "meeting_id": "mt_3NKDYYE",
                "course": "Fontwell",
                "time": "14:10",
                "off_time": "14:10:27",
                "name": "Glen Scotia Single Malt Handicap Chase",
                "run_type": null,
                "class": "4",
                "distance": "2m 5f 135y",
                "going": "Soft (Good to Soft in places)",
                "surface": "TURF",
                "handicap": true,
                "runners": 7,
                "result_available": true
            },
            {
                "race_id": "rc_3JE43TV",
                "meeting_id": "mt_3NKDYYE",
                "course": "Fontwell",
                "time": "14:40",
                "off_time": "14:40:11",
                "name": "Enjoy Champagne PIAFF Novices' Limited Handicap Chase (GBB Race)",
                "run_type": null,
                "class": "3",
                "distance": "2m 3f 104y",
                "going": "Soft (Good to Soft in places)",
                "surface": "TURF",
                "handicap": true,
                "runners": 4,
                "result_available": true
            },
            "… 5 more"
        ]
    }
}

A real response from /v1/meetings/mt_3NKDYYE, 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
meeting_id	string	Opaque meeting identifier. A meeting is one course on one day.
course_id	string	Opaque course identifier.
course	string	Course name.
country	string	Country code as the source publishes it.
region	string	Jurisdiction, normalised. Welsh and Scottish racing is GB.
date	date	Race date, YYYY-MM-DD.
going	string	Ground description at the off.
surface	string	Turf, Dirt, Polytrack and so on.
race_id	string	Opaque race identifier. Stable, and safe to store.
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".
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.

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.

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.
outside_window	403	You asked for a date your plan cannot see. The body names the window and the date you asked for. Search endpoints clamp instead of refusing, and report what they actually searched in meta.
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.
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.

meeting_id

What this is for

One meeting and every race on it: the conditions once, at the top, and then the card in time order. The shape you want when a user has clicked a track rather than a race.

Going, surface and weather belong to the meeting rather than to each race, so they are returned once here instead of repeated on every row.

Common uses

A meeting page

One request renders the whole thing. The race identifiers are there for the links.

Grouping your own storage

Meetings are stable identifiers, so they make a sensible key for anything you cache per track per day.