Leagues
League profiles, league lists, standings and cup brackets. A league profile carries its seasons array and the IDs of the current season, stage and round, which are the entry points for fixtures, standings and leaders.
Open in the interactive reference
Operations
- GETAll leagues — Leagues available to the account, optionally filtered by country. Paginated, 100 items per page.
- GETLeague by ID — League profile with seasons and current season, stage and round.
- GETLeagues by multiple IDs — Several league profiles in one request.
- GETStandings — League table for a season. Competitions with several tables (groups, splits) return one entry per table, identified by
number_standings. - GETLive standings — Rolling table that includes the matches currently in play.
- GETCup draw (tournament bracket) — Knockout bracket of a cup stage.
Route reference
Operations
The t query parameter selects the operation. Parameters not listed for an operation are ignored.
t |
Operation | Required | Optional |
|---|---|---|---|
list |
All leagues. Leagues available to the account, optionally filtered by country. Paginated, 100 items per page. | — | country_id, page |
info |
League by ID. League profile with seasons and current season, stage and round. | id |
— |
sort |
Leagues by multiple IDs. Several league profiles in one request. | ids |
— |
standings |
Standings. League table for a season. Competitions with several tables (groups, splits) return one entry per table, identified by number_standings. |
season_id |
— |
standings_live |
Live standings. Rolling table that includes the matches currently in play. | season_id |
— |
cup_draw |
Cup draw (tournament bracket). Knockout bracket of a cup stage. | season_id, stage_id |
— |
The public reference shows t=multiple&id=… on one page for the batch lookup; t=sort&ids=… is the form shared with teams and fixtures.
Examples
All leagues:
GET /v2.2/leagues/?user=USER&token=TOKEN&t=list&country_id=4
League by ID:
GET /v2.2/leagues/?user=USER&token=TOKEN&t=info&id=1005
Leagues by multiple IDs:
GET /v2.2/leagues/?user=USER&token=TOKEN&t=sort&ids=974,1005,1609
Standings:
GET /v2.2/leagues/?user=USER&token=TOKEN&t=standings&season_id=406
Live standings:
GET /v2.2/leagues/?user=USER&token=TOKEN&t=standings_live&season_id=406
Cup draw (tournament bracket):
GET /v2.2/leagues/?user=USER&token=TOKEN&t=cup_draw&season_id=45&stage_id=26