Leagues by Country ID
GET https://soccer.sportmonks.com/api/v2.0/countries/:COUNTRY_ID/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
NO - 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 |
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":240949,"current_stage_id":77448542,"live_standings":true,"coverage":{"predictions":true,"topscorer_goals":true,"topscorer_assists":true,"topscorer_cards":true}},{"id":1659,"active":true,"type":"domestic","legacy_id":null,"country_id":320,"logo_path":"https://cdn.sportmonks.com/images//soccer/leagues/27/1659.png","name":"Superliga Play-offs","is_cup":false,"current_season_id":18101,"current_round_id":null,"current_stage_id":null,"live_standings":false,"coverage":{"predictions":true,"topscorer_goals":true,"topscorer_assists":true,"topscorer_cards":true}}],"meta":{"plans":[{"name":"Free Plan","request_limit":"180,60"}],"sports":[{"id":1,"name":"Soccer","current":true},{"id":6,"name":"Cricket","current":false}],"pagination":{"total":2,"count":2,"per_page":100,"current_page":1,"total_pages":1,"links":{}}}}