Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

League

GET

/v2/leagues/{id}

All plans

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

id

pathrequired

league id issued by DataSportsAPI, a positive integer

Response

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