Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Race sports

Series races

GET

/v2/series/{id}/races

All plans

View as MarkdownTry in Playground →

Lists the races in one season of a series. Sessions are left out here; fetch them from /v2/races/{id}.

Parameters

id

pathrequired

series id issued by DataSportsAPI, a positive integer

season

query

season id from /v2/series/{id}/seasons; the most recent season is used if omitted

Response

meta
season (the season actually served), count, and historyFrom when your plan’s history window hid older races
errors
400 bad_request — season is invalid403 history_not_in_plan — your plan’s history window begins after this season ended404 not_found — the season id is not among this series’ seasons; 404 no_data — no seasons exist for the series

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/series/{id}/races"
Example
{ "data": [ { "id": 812210, "name": "Australian GP", "round": 1, "status": "finished", "startDate": "2026-03-06", "endDate": "2026-03-08",
    "circuit": { "name": "Albert Park", … }, "winner": { … }, … }, … ],
  "meta": { "season": 812301, "count": 24 } }