Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Teams

Season races

GET

/v2/teams/{id}/races

All plans

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

id

pathrequired

DataSportsAPI team id, a positive integer

season

queryrequired

series season id, taken from /v2/teams/{id}/race-career or /v2/series/{id}/seasons

Response

meta
season, count; historyFrom appears if your plan trimmed older races
errors
400 bad_request — the season parameter was not supplied403 history_not_in_plan — all of the season’s races predate your plan’s history window404 not_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 } }