All leagues
GET https://soccer.sportmonks.com/api/v2.0/leagues
Introduction
The Leagues endpoint is for most customers the starting point. A request on this endpoint would return a response with all Leagues you have access to, based on the plan you are subscribed to.
The Leagues endpoint provides you League information like its ID, Name, Country, Coverage etc.
The endpoint is often used in combination with the Season or Seasons Includes. Where the Season include returns information about the active Season only, the Seasons Include returns information about all seasons available for the specific Leagues.
Pagination
YES - Indicates if this endpoint contains pagination.
Nested Includes
2 - You can add a max of 2 levels of nested includes.
Includes Options
country season seasons
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
include | null | Enrich the API with more data and/or nested includes | |
cupslast | null | When provided via the request url the cups will be put on the end of the response. |
RESPONSES
status: OK
{"data":[{"id":271,"active":true,"type":"domestic","legacy_id":43,"country_id":320,"logo_path":"https://cdn.sportmonks.com/images/soccer/leagues/271.png","name":"Superliga","is_cup":false,"current_season_id":17328,"current_round_id":199447,"current_stage_id":77447994,"live_standings":true,"coverage":{"predictions":true,"topscorer_goals":true,"topscorer_assists":true,"topscorer_cards":true}},{"id":501,"active":true,"type":"domestic","legacy_id":66,"country_id":1161,"logo_path":"https://cdn.sportmonks.com/images/soccer/leagues/501.png","name":"Premiership","is_cup":false,"current_season_id":17141,"current_round_id":194969,"current_stage_id":77447501,"live_standings":true,"coverage":{"predictions":true,"topscorer_goals":true,"topscorer_assists":true,"topscorer_cards":true}}],"meta":{"subscription":{"started_at":{"date":"2019-09-02 09:52:14.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":{"date":"2019-09-16 09:52:10.000000","timezone_type":3,"timezone":"UTC"},"ends_at":null},"plan":{"name":"PostMan Plan","price":"25.00","request_limit":"2000,60"},"sports":[{"id":1,"name":"Soccer","current":true}],"pagination":{"total":2,"count":2,"per_page":100,"current_page":1,"total_pages":1,"links":{}}}}