Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Race sports

Series standings

GET

/v2/series/{id}/standings

All plans

View as MarkdownTry in Playground →

A season’s championship table for drivers / riders (type=competitors, default) or teams (type=teams), listing points, wins, podiums, pole positions and fastest laps, plus races started and points-scoring races.

Cycling has no teams standings and returns an empty array for them. In the teams table, team is null. Columns our data source does not track are null. meta.figuresSource says whether wins / podiums / polePositions / racesStarted / racesWithPoints are upstream (taken from the source’s own table) or computed. They are computed for MotoGP, whose table carries only positions and points: we derive the figures from the main race of every completed round — a win is 1st place, a podium a top-3 finish, a pole grid position 1; sprints are ignored, and a team is credited for each of its entries, with one start per race. For MotoGP, fastestLaps remains null.

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

type

query

competitors (default) | teams

Response

meta
season (the season actually served), type, count, figuresSource (upstream | computed)
errors
400 bad_request — the season id is invalid, or type is something other than competitors|teams403 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}/standings"
Example
{ "data": [ { "position": 1, "competitor": { "id": 700003, "name": "Lando Norris", … }, "team": { "id": 700011, "name": "McLaren", … },
    "points": 357, "wins": 7, "podiums": 15, "polePositions": 6, "fastestLaps": 5, "racesStarted": 17, "racesWithPoints": 17 }, … ],
  "meta": { "season": 812301, "type": "competitors", "count": 21, "figuresSource": "upstream" } }

// MotoGP (figures counted by us from the season's main races):
{ "data": [ { "position": 1, "competitor": { "name": "Marc Márquez", … }, "team": { "name": "Ducati Lenovo Team", … },
    "points": 545, "wins": 11, "podiums": 15, "polePositions": 8, "fastestLaps": null, "racesStarted": 17, "racesWithPoints": 16 }, … ],
  "meta": { "season": 696722, "type": "competitors", "count": 32, "figuresSource": "computed" } }