Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Seasons

GET

/v2/leagues/{id}/seasons

All plans

View as MarkdownTry in Playground →

Lists the league’s seasons, most recent first. year is the label to display, while startYear / endYear hold the numeric years — identical when a season runs within one calendar year.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

Response

data
Season[]
meta
count
errors
404 no_data — our data source keeps no season list for this league

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/seasons"
Example
{ "data": [ { "id": 200386, "name": "Premier League 26/27", "year": "26/27", "startYear": 2026, "endYear": 2027 }, … ],
  "meta": { "count": 34 } }