Series races

GET

https://api.datasportsapi.com/v2/series/{id}/races

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 1 optional
Returns: RaceSummary[]

Try in Playground

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

01Parameters

Name	In	Required	Description
`id`	path	Required	series id issued by DataSportsAPI, a positive integer
`season`	query	Optional	season id from /v2/series/{id}/seasons; the most recent season is used if omitted

idpathRequired
series id issued by DataSportsAPI, a positive integer
seasonqueryOptional
season id from /v2/series/{id}/seasons; the most recent season is used if omitted

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/series/{id}/races"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data: RaceSummary[]
meta: season (the season actually served), count, and historyFrom when your plan’s history window hid older races

ObjectsRaceSummary

Example response

3 lines

{ "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 } }

04Errors

400bad_request
season is invalid
403history_not_in_plan
your plan’s history window begins after this season ended
404not_found
the season id is not among this series’ seasons; 404 no_data — no seasons exist for the series

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code