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. The plans column lists the plans that include the operation for the leagues they cover; Free plans carry the Standard datasets. A plan outside the list receives 403 with meta.msg = Endpoint not available for your plan.
t |
Operation | Required | Optional | Plans |
|---|---|---|---|---|
list |
All leagues. Leagues available to the account, optionally filtered by country. Paginated, 100 items per page. | — | country_id, page |
All plans |
info |
League by ID. League profile with seasons and current season, stage and round. | id |
— | All plans |
sort |
Leagues by multiple IDs. Several league profiles in one request. | ids |
— | All plans |
standings |
Standings. League table for a season. Competitions with several tables (groups, splits) return one entry per table, identified by number_standings. |
season_id |
— | Standard, World Cup |
standings_live |
Live standings. Rolling table that includes the matches currently in play. | season_id |
— | Standard, World Cup |
cup_draw |
Cup draw (tournament bracket). Knockout bracket of a cup stage. | season_id, stage_id |
— | Standard, World Cup |
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/?api_key=API_KEY&t=list&country_id=4
League by ID:
GET /v2.2/leagues/?api_key=API_KEY&t=info&id=1005
Leagues by multiple IDs:
GET /v2.2/leagues/?api_key=API_KEY&t=sort&ids=974,1005,1609
Standings:
GET /v2.2/leagues/?api_key=API_KEY&t=standings&season_id=406
Live standings:
GET /v2.2/leagues/?api_key=API_KEY&t=standings_live&season_id=406
Cup draw (tournament bracket):
GET /v2.2/leagues/?api_key=API_KEY&t=cup_draw&season_id=45&stage_id=26