1 of 5

Leagues

For most customers, the Leagues endpoint is the starting point. A request on this endpoint returns 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.

Check this endpoint in Postman.

GET All Leagues

`GET` All Leagues

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

Parameters

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:

Example response

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

 "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
            }
        },

GET League by ID

`GET` League by ID

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

Parameters

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:

Example response

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

"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
        }
    },

Check this endpoint in Postman.

GET Leagues by Country ID

`GET` League by Country ID

https://soccer.sportmonks.com/api/v2.0/countries/{ID}/leagues

Parameters

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:

Example response

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

    "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": 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
            }
        },
        {
            "id": 12,
            "active": true,
            "type": "domestic",
            "legacy_id": 34,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/12/12.png",
            "name": "League One",
            "is_cup": false,
            "is_friendly": false,
            "current_season_id": 18433,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": true,
            "coverage": {
                "predictions": true,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },
        {
            "id": 14,
            "active": true,
            "type": "domestic",
            "legacy_id": 32,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/14/14.png",
            "name": "League Two",
            "is_cup": false,
            "is_friendly": false,
            "current_season_id": 18434,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": true,
            "coverage": {
                "predictions": true,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },

Check this endpoint in Postman.

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}

Parameters

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:

Example response

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

"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
            }
        },

GET All Leagues

`GET` All Leagues

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

Parameters

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:

Example response

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

 "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
            }
        },

Check this endpoint in Postman.

GET Leagues by Country ID

`GET` League by Country ID

https://soccer.sportmonks.com/api/v2.0/countries/{ID}/leagues

Parameters

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:

Example response

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

    "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": 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
            }
        },
        {
            "id": 12,
            "active": true,
            "type": "domestic",
            "legacy_id": 34,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/12/12.png",
            "name": "League One",
            "is_cup": false,
            "is_friendly": false,
            "current_season_id": 18433,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": true,
            "coverage": {
                "predictions": true,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },
        {
            "id": 14,
            "active": true,
            "type": "domestic",
            "legacy_id": 32,
            "country_id": 462,
            "logo_path": "https://cdn.sportmonks.com/images/soccer/leagues/14/14.png",
            "name": "League Two",
            "is_cup": false,
            "is_friendly": false,
            "current_season_id": 18434,
            "current_round_id": null,
            "current_stage_id": null,
            "live_standings": true,
            "coverage": {
                "predictions": true,
                "topscorer_goals": true,
                "topscorer_assists": true,
                "topscorer_cards": true
            }
        },

Check this endpoint in Postman.

Search Leagues by Name

Search League by Name

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

Parameters

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:

Example response

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

"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
            }
        },

Check this endpoint in Postman.

Leagues

GET All Leagues

GET All Leagues

Parameters

Include options

Example response

GET League by ID

GET League by ID

Parameters

Include options

Example response

GET Leagues by Country ID

GET League by Country ID

Parameters

Include options

Example response

Search Leagues by Name

Search League by Name

Parameters

Include options

Example response

GET All Leagues

GET All Leagues

Parameters

Include options

Example response

GET League by ID

GET League by ID

Parameters

Include options

Example response

GET Leagues by Country ID

GET League by Country ID

Parameters

Include options

Example response

Leagues

Search Leagues by Name

Search League by Name

Parameters

Include options

Example response

`GET` All Leagues

`GET` League by ID

`GET` League by Country ID

`GET` All Leagues

`GET` League by ID

`GET` League by Country ID