League

GET

https://api.datasportsapi.com/v2/leagues/{id}

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: LeagueDetail

Returns a league’s profile: its tier (where it sits in the national pyramid), gender, the reigning champion with its title count, the clubs holding the most titles, the divisions directly above and below, and the opening and closing dates of the current season.

category reflects how our data source groups leagues — by country, by region (e.g. International), by tour (e.g. ATP) or by esports title; country is populated only for categories that are countries.

01Parameters

Name	In	Required	Description
`id`	path	Required	league id issued by DataSportsAPI, a positive integer

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}"

03Response

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

data: LeagueDetail

ObjectsLeagueDetail

Example response

9 lines

{ "data": { "id": 195828, "name": "Premier League", "slug": "premier-league", "sport": "football",
    "category": "England", "country": { "code": "EN", "name": "England" },
    "image": "https://cdn.datasportsapi.com/v2/leagues/195828/logo",
    "tier": 1, "gender": "male",
    "titleHolder": { "id": 4500, "name": "Liverpool", "slug": "liverpool", "shortName": "Liverpool", "code": "LIV", "image": "…" },
    "titleHolderTitles": 20, "mostTitles": 20,
    "mostTitlesTeams": [ { "id": 4501, "name": "Manchester United", … }, { "id": 4500, "name": "Liverpool", … } ],
    "upperDivisions": [], "lowerDivisions": [ { "id": 195850, "name": "Championship", … } ],
    "currentSeasonStart": "2026-08-21", "currentSeasonEnd": "2027-05-23" } }

04Errors

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

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code