DataSportAPI
Docs
Your first call in one line

The free key reads yesterday for every sport, 50 calls a day. No card.

Get a free key
Every sport, one key

Complete reads all sixteen sports for $249 a month.

Take Complete
Ask in plain words

"Who won at Kempton yesterday?" Your assistant picks the tool and answers from your plan.

Connect in two minutes
Showing
Documentation / Horses / Racecards

Horses today's racecards API

Today's racecards
Sport plan, liveMCP tool: racecards_todayKept 2 minutes

Today's racecards with every runner.

This lists what is coming, with start times in UTC and the ids that carry on into results once played. It comes with the Horses plan.

GET/v1/horses/cards/today

Try it

Your key stays in this browser and is filled in on every docs page.

GET
200 OK1904 ms2 rows shownReal answer from 2026-11-03, trimmed
{
    "data": [
        {
            "meeting_id": "hr_47vd1aaq34",
            "course_id": "hr_09p43gn5kp",
            "course": "Bunbury",
            "country": "AUS",
            "region": "AUS",
            "date": "2026-11-03",
            "going": null,
            "surface": "Turf",
            "races": [
                {
                    "race_id": "hr_hjk8a516c1",
                    "meeting_id": "hr_47vd1aaq34",
                    "course": "Bunbury",
                    "time": "05:31",
                    "off_time": null,
                    "name": "BUNBURY RSL DIGGERS MAIDEN",
                    "run_type": "Flat",
                    "class": "Maiden",
                    "distance": "1200m",
                    "going": null,
                    "surface": "Turf",
                    "handicap": false,
                    "runners": 8,
                    "result_available": false
                },
                {
                    "race_id": "hr_109skpt39s",
                    "meeting_id": "hr_47vd1aaq34",
                    "course": "Bunbury",
                    "time": "06:18",
                    "off_time": null,
                    "name": "TREVOR ROCHE MEMORIAL MAIDEN",
                    "run_type": "Flat",
                    "class": "Maiden",
                    "distance": "1400m",
                    "going": null,
                    "surface": "Turf",
                    "handicap": false,
                    "runners": 8,
                    "result_available": false
                },
                {
                    "race_id": "hr_h7kev6pt1s",
                    "meeting_id": "hr_47vd1aaq34",
                    "course": "Bunbury",
                    "time": "06:48",
                    "off_time": null,
                    "name": "CUPRUM DISTILLERY - VODKA, PASSIONFRUIT & SODA MAIDEN",
                    "run_type": "Flat",
                    "class": "Maiden",
                    "distance": "1100m",
                    "going": null,
                    "surface": "Turf",
                    "handicap": false,
                    "runners": 10,
                    "result_available": false
                }
            ]
        },
        {
            "meeting_id": "hr_mfk8w69vk0",
            "course_id": "hr_f6tkmwg2r5",
            "course": "Bundaberg",
            "country": "AUS",
            "region": "AUS",
            "date": "2026-11-03",
            "going": "Soft",
            "surface": "Dirt",
            "races": [
                {
                    "race_id": "hr_kvks62takb",
                    "meeting_id": "hr_mfk8w69vk0",
                    "course": "Bundaberg",
                    "time": "03:10",
                    "off_time": null,
                    "name": "CRAFT RENTAL & HARDWARE BENCHMARK 50 Handicap",
                    "run_type": "Flat",
                    "class": null,
                    "distance": "1212m",
                    "going": "Soft",
                    "surface": "Dirt",
                    "handicap": true,
                    "runners": 7,
                    "result_available": true
                },
                {
                    "race_id": "hr_41fgms4r33",
                    "meeting_id": "hr_mfk8w69vk0",
                    "course": "Bundaberg",
                    "time": "03:45",
                    "off_time": null,
                    "name": "BUNDY STAR Maiden Plate",
                    "run_type": "Flat",
                    "class": null,
                    "distance": "850m",
                    "going": null,
                    "surface": "Dirt",
                    "handicap": false,
                    "runners": 9,
                    "result_available": false
                },
                {
                    "race_id": "hr_yhr3znzz2v",
                    "meeting_id": "hr_mfk8w69vk0",
                    "course": "Bundaberg",
                    "time": "04:20",
                    "off_time": null,
                    "name": "THABEBAN CELLARS BENCHMARK 55 Handicap",
                    "run_type": "Flat",
                    "class": null,
                    "distance": "850m",
                    "going": null,
                    "surface": "Dirt",
                    "handicap": true,
                    "runners": 10,
                    "result_available": false
                }
            ]
        }
    ],
    "meta": {
        "sport": "horses",
        "endpoint": "/cards/today",
        "count": 47,
        "as_of": "2026-11-03T04:22:33+00:00",
        "cached": false,
        "age_seconds": 0
    }
}
No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.

Parameters

This call takes no query values.

Returns

Each row of data, from a real answer. Every id is ours and opens its own endpoint.

FieldTypeWhat it holds
meeting_ididThe meeting, by our id
course_ididThe course, by our id
coursestringThe course
countrystringThe country
regionstringThe region
datedateThe day, YYYY-MM-DD
goingnullThe going
surfacestringTurf, all-weather or similar
raceslistThe races in it
metaWhat it holds
sport, endpointWhat you asked
countRows in this answer
page, per_page, total, next_cursorWhere you are in a paged list, when it is paged
as_ofWhen the data was built
cached, age_secondsWhether this is a stored copy, and its age
accessOn the free key: what it reads, and the plan that opens the rest

Errors

Codes this call can give. Each is explained in Errors.

StatusCodeWhen
401no_keyNo key sent, or not in a form we read
401bad_keyA key we do not know
403planThe free key, or a sport you do not hold
422bad_paramA value this call does not take
429rateOver the calls a minute for your plan
503upstreamThe data is not answering; retry after Retry-After

Today's racecards comes with the Horses plan, $79 a month, with every date held and 250,000 calls a month.

Add Horses