Races
GET
/
View as MarkdownTry in Playground →
Returns every race that has a session beginning on a given UTC day, with all of each race’s sessions included.
A day lists no more than 40 races. A race weekend shows up on each day on which one of its sessions begins. Our data source sometimes records a weekend twice, under two identically named series (NASCAR Cup Series); we drop the copy whose series has no seasons from the day’s list, although its id still resolves on /v2/races/{id}.
Parameters
sportqueryrequired
motorsport | cycling
datequeryrequired
UTC date in YYYY-MM-DD format
Response
- data
Race[]- meta
- date, sport, count, complete (false if some races were temporarily unavailable — try again shortly)
- errors
- 400
bad_request— the date is missing or not a valid day, or the sport is not one of the race sports403history_not_in_plan— your plan’s history does not reach back to that date503upstream_unavailable— every race of the day failed to load
Any /v2 call can also come back with one of the common errors.
Example
$ curl -H "Authorization: Bearer sk_live_…" "https://api.datasportsapi.com/v2/races?sport=motorsport&date=2026-10-11"
{ "data": [ { "id": 812345, "name": "Singapore GP", "sport": "motorsport", "series": { "id": 812300, "name": "Formula 1", … },
"status": "finished", "startDate": "2026-10-09", "endDate": "2026-10-11", "sessions": [ … ], … }, … ],
"meta": { "date": "2026-10-11", "sport": "motorsport", "count": 3, "complete": true } }