Season races
GET
/
View as MarkdownTry in Playground →
For race sports, how a driver or constructor finished in every race of one series season: a driver’s grid slot, position, points, race time and gap, or a constructor’s position, points and its drivers’ placings. Available since 2026-11-04.
Races run oldest first. Each row reflects the weekend’s main race; sprint results live at /v2/races/{id}/results?session=. A driver who did not finish or start shows position null, a state such as didNotFinish / didNotStart / … and an outReason. The list is empty if the competitor took no part in that season.
Parameters
idpathrequired
DataSportsAPI team id, a positive integer
seasonqueryrequired
series season id, taken from /v2/teams/{id}/race-career or /v2/series/{id}/seasons
Response
- data
TeamRaceResult[]- meta
- season, count; historyFrom appears if your plan trimmed older races
- errors
- 400
bad_request— the season parameter was not supplied403history_not_in_plan— all of the season’s races predate your plan’s history window404not_found— DataSportsAPI has never assigned this id
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/teams/{id}/races?season=…"Example
{ "data": [ { "race": { "id": 300512, "name": "USA GP", "round": 18, … }, "position": 1, "points": 25, "state": "classified", "outReason": null,
"gridPosition": 1, "timeMs": 5716650, "gapMs": null, "drivers": [] }, … ],
"meta": { "season": 300480, "count": 19 } }