Search League by Name
GET https://soccer.sportmonks.com/api/v2.0/leagues/search/:LEAGUE_NAME
Introduction
This endpoint returns an array of Leagues that meet your search criteria. Note that it will not return Leagues that are not covered by your subscription plan. 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":199447,"current_stage_id":77447994,"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}]}}