Search Leagues by Name

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 League information like its ID, Name, Country, Coverage etc.

Search League by Name

https://soccer.sportmonks.com/api/v2.0/leagues/search/{league_name}

Endpoint details
Authorization	API Key
Pagination	NO
Allowed nested includes	2

Parameters

Available parameters
include	Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

Include options

country season seasons

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Includes

Example response

Request

https://soccer.sportmonks.com/api/v2.0/leagues/search/premier?api_token={API_TOKEN}

Response

"data": [
        {
            "id": 8,
            "active": true,
            "type": "domestic",
            "legacy_id": 29,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/8/8.png",
            "name": "Premier League",
            "is_cup": false,
            "is_friendly": false,
            "current_season_id": 18378,
            "current_round_id": null,
            "current_stage_id": 77453700,
            "live_standings": true,
            "coverage": {
                "predictions": true,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },
        {
            "id": 32,
            "active": true,
            "type": "domestic_cup",
            "legacy_id": 474,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/0/32.png",
            "name": "Premier League Cup",
            "is_cup": true,
            "is_friendly": false,
            "current_season_id": 16589,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": false,
            "coverage": {
                "predictions": false,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },
        {
            "id": 35,
            "active": true,
            "type": "domestic",
            "legacy_id": 290,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/3/35.png",
            "name": "Premier League U21",
            "is_cup": false,
            "is_friendly": false,
            "current_season_id": null,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": false,
            "coverage": {
                "predictions": false,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },
        {
            "id": 38,
            "active": true,
            "type": "domestic_cup",
            "legacy_id": null,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/6/38.png",
            "name": "Premier League International Cup",
            "is_cup": true,
            "is_friendly": false,
            "current_season_id": 16558,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": false,
            "coverage": {
                "predictions": false,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },

Field Description

Field	Description
data	Opens an array of data you've requested
id	A unique league id
active	Indicates if the league is active or not. Possible values are 'true' or 'false'
type	Indicates what kind of league this is. Possible values: 'domestic', 'cup', 'international'. More values can be found here
legacy_id	This was for our API version 1.0. It's only of use for old users of our API
country_id	The unique country id the league is played in
logo_path	The logo URL path of the league
name	The name of the league
is_cup	Indicates if the league is a cup or not. Possible values are 'true' or 'false'
current_season_id	The unique id of the current season
current_round_id	The unique id of the current round
current_stage_id	The unique id of the current stage
live_standings	Indicates if the league covers live standings
coverage	Opens an array of partial coverage for the league
predictions	Indicates if the league covers predictions
topscorers_goals	Indicates if the league covers goal topscorers
topscorers_assists	Indicates if the league covers assists topscorers
topscorers_cards	Indicates if the league covers cards topscorers

Check this endpoint in Postman.