Skip to content
datasportsAPI

TeamsSeason races

Documentation

/

Type to filter the docs by title or path.

TeamsEndpoint 38 of 116

Season races

GET

/v2/teams/{id}/races

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
2 required · 0 optional
Returns
TeamRaceResult[]
Try in Playground

For race sports, how a driver or constructor finished in every race of one series season. A driver’s row: position, points, grid slot, race time, gap. A constructor’s row: its position, its points and where its drivers placed. Available since 2026-11-04.

Worth knowing

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.

01Parameters

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/teams/{id}/races?season=…"

03Response

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

data
TeamRaceResult[]
meta
season, count; historyFrom appears if your plan trimmed older races
ObjectsTeamRaceResult
Example response
{ "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 } }

04Errors

  • 400bad_request

    the season parameter was not supplied

  • 403history_not_in_plan

    all of the season’s races predate your plan’s history window

  • 404not_found

    DataSportsAPI has never assigned this id

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code