Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Season teams

GET

/v2/leagues/{id}/teams

All plans

View as MarkdownTry in Playground →

Lists the participants of a single league season; works just as well for cups and other competitions that have no table.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

Response

data
TeamRef[]
meta
season, count
errors
403 history_not_in_plan — your plan’s history window begins after this season ended404 not_found — the season id does not belong to 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}/teams?season=…"
Example
{ "data": [ { "id": 18, "name": "Arsenal", "code": "ARS", … }, { "id": 17, "name": "Leeds United", "code": "LEE", … }, … ], "meta": { "season": 200386, "count": 20 } }