Skip to content
datasportsAPI

LeaguesChampions

Documentation

/

Type to filter the docs by title or path.

LeaguesEndpoint 66 of 116

Champions

GET

/v2/leagues/{id}/champions

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
LeagueChampion[]
Try in Playground

Recent title winners of the league, most recent first — each entry gives the season, the year in which it finished and the champion.

Worth knowing

Covers only the last ten seasons our data source records; no earlier page exists. Competitions for which the source records no champions return an empty list.

01Parameters

  • idpathRequired

    league id issued by DataSportsAPI, a positive integer

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/leagues/{id}/champions"

03Response

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

data
LeagueChampion[]
meta
count
ObjectsLeagueChampion
Example response
{ "data": [ { "seasonId": 200310, "year": 2026, "team": { "id": 18, "name": "Arsenal", … } }, { "seasonId": 200290, "year": 2025, "team": { "id": 21, "name": "Liverpool FC", … } }, … ],
  "meta": { "count": 10 } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code