# GET /v2/series/{id}/standings

Group: Race sports

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.

Plans: Every plan, Free included.

Note: 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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | series id issued by DataSportsAPI, a positive integer |
| `season` | query | no | season id from /v2/series/{id}/seasons; the most recent season is used if omitted |
| `type` | query | no | competitors (default) \| teams |

## Response

- `data`: `SeriesStandingsRow[]`
- `meta`: season (the season actually served), type, count, figuresSource (upstream | computed)
- Objects: SeriesStandingsRow (https://datasportsapi.com/markdown/reference.md#seriesstandingsrow)

## Errors

- 400 bad_request — the season id is invalid, or type is something other than competitors|teams
- 403 history_not_in_plan — your plan’s history window begins after this season ended
- 404 not_found — the season id is not among this series’ seasons; 404 no_data — no seasons exist for the series

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/series/{id}/standings"
```

TypeScript:

```ts
const { data, meta } = await client.series.standings(id);
```

Python:

```python
res = client.series.standings(id)
```

Go:

```go
res, err := client.Series.Standings(ctx, id, &datasportsapi.SeriesStandingsParams{})
```

CLI:

```bash
$ dsa series standings <id>
```

## Example response

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

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/races/series-standings/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
