League
GET
/
View as MarkdownTry in Playground →
A league’s profile: tier (level in the national pyramid), gender, reigning champion and its title count, clubs with the most titles, the divisions above and below, and when the current season starts and ends. The category field 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.
Parameters
idpathrequired
league id issued by DataSportsAPI, a positive integer
Response
- data
LeagueDetail
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}"Example
{ "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" } }