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.

GET All Leagues

`GET` All Leagues

Endpoint details

Authorization

API Key

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

Check this endpoint in Postman.

GET League by ID

`GET` League by ID

Endpoint details

Authorization

API Key

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

Check this endpoint in Postman.

GET Leagues by Country ID

`GET` League by Country ID

Endpoint details

Authorization

API Key

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

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

Endpoint details

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

Check this endpoint in Postman.

GET League by ID

`GET` League by ID

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

Endpoint details

Authorization

API Key

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

Check this endpoint in Postman.

GET All Leagues

`GET` All Leagues

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

Endpoint details

Authorization

API Key

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

Check this endpoint in Postman.

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

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

Search Leagues by Name

Search League by Name

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

Endpoint details

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

Check this endpoint in Postman.

"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 Leagues by Country ID

`GET` League by Country ID

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

Endpoint details

Authorization

API Key

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

Check this endpoint in Postman.

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

Leagues

GET All Leagues

hashtagGET All Leagues

hashtagParameters

hashtagInclude options

hashtagExample response

GET League by ID

hashtagGET League by ID

hashtagParameters

hashtagInclude options

hashtagExample response

GET Leagues by Country ID

hashtagGET League by Country ID

hashtagParameters

hashtagInclude options

hashtagExample response

Search Leagues by Name

hashtagSearch League by Name

hashtagParameters

hashtagInclude options

hashtagExample response

GET League by ID

hashtagGET League by ID

hashtagParameters

hashtagInclude options

hashtagExample response

GET All Leagues

hashtagGET All Leagues

hashtagParameters

hashtagInclude options

hashtagExample response

Leagues

Search Leagues by Name

hashtagSearch League by Name

hashtagParameters

hashtagInclude options

hashtagExample response

GET Leagues by Country ID

hashtagGET League by Country ID

hashtagParameters

hashtagInclude options

hashtagExample response

`GET` All Leagues

Parameters

Include options

Example response

`GET` League by ID

Parameters

Include options

Example response

`GET` League by Country ID

Parameters

Include options

Example response

Search League by Name

Parameters

Include options

Example response

`GET` League by ID

Parameters

Include options

Example response

`GET` All Leagues

Parameters

Include options

Example response

Search League by Name

Parameters

Include options

Example response

`GET` League by Country ID

Parameters

Include options

Example response