Series

GET

https://api.datasportsapi.com/v2/series

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: SeriesRef[]

Lists the series that belong to a race-sport category. Examples: Nascar → NASCAR Cup Series, Truck Series, Xfinity; Formula 1 → Formula 1; cycling’s International → Cycling Men, Cycling Women.

Worth knowing

You get an empty list for a category that holds no series, such as motorsport’s International or any category belonging to a fixture sport. A series id from here works with /v2/series/{id}/seasons, /races and /standings.

01Parameters

Name	In	Required	Description
`category`	query	Required	motorsport or cycling category id — list them with /v2/categories?sport=motorsport or ?sport=cycling

categoryqueryRequired
motorsport or cycling category id — list them with /v2/categories?sport=motorsport or ?sport=cycling

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/series?category=…"

03Response

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

data: SeriesRef[]
meta: category, count

ObjectsSeriesRef

Example response

3 lines

{ "data": [ { "id": 696772, "name": "NASCAR Cup Series", "slug": "nascar-cup-series", "sport": "motorsport" },
    { "id": 812301, "name": "NASCAR Craftsman Truck Series", "slug": "nascar-camping-world", "sport": "motorsport" }, … ],
  "meta": { "category": 696300, "count": 3 } }

04Errors

400bad_request
category is absent or invalid
404not_found
DataSportsAPI never issued this category id

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code