GET All Leagues

GET All Leagues

https://soccer.sportmonks.com/api/v2.0/leagues

Endpoint details
Authorization	API Key
Pagination	YES
Allowed nested includes	2

Parameters

Available parameters
page	The number of the page you want to browse. Can be used by adding &page= etc to your request url.
include	Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.
cupslast	When provided via the request url the cups will be put on the end of the response.

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?api_token={API_TOKEN}

Response

 "data": [
        {
            "id": 2,
            "active": true,
            "type": "cup_international",
            "legacy_id": 11,
            "country_id": 41,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/2.png",
            "name": "Champions League",
            "is_cup": true,
            "is_friendly": false,
            "current_season_id": 18346,
            "current_round_id": null,
            "current_stage_id": 77453623,
            "live_standings": true,
            "coverage": {
                "predictions": false,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },
        {
            "id": 5,
            "active": true,
            "type": "cup_international",
            "legacy_id": 12,
            "country_id": 41,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/5.png",
            "name": "Europa League",
            "is_cup": true,
            "is_friendly": false,
            "current_season_id": 18629,
            "current_round_id": null,
            "current_stage_id": 77454501,
            "live_standings": true,
            "coverage": {
                "predictions": false,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },
        {
            "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": 9,
            "active": true,
            "type": "domestic",
            "legacy_id": 30,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/9/9.png",
            "name": "Championship",
            "is_cup": false,
            "is_friendly": false,
            "current_season_id": 18432,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": true,
            "coverage": {
                "predictions": true,
                "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.