Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Race sports

Races

GET

/v2/races

All plans

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

sport

queryrequired

motorsport | cycling

date

queryrequired

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 sports403 history_not_in_plan — your plan’s history does not reach back to that date503 upstream_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 } }