1 of 3

Seasons

Responses of the Seasons endpoint are limited to Seasons of the Leagues available in the Plan you are subscribed to. Responses provide you details like the Season ID, Name, League ID, Year and if the Season is Active Yes or No.

One of the main features of the Seasons endpoint is the ability to retrieve full Season Games, (history) Fixtures, Results or Upcoming Fixtures. This can be achieved by using the proper Includes, which are listed in the section Endpoint Details.

Check this endpoint in Postman.

GET All Seasons

`GET` All Seasons

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

Parameters

Include options

league stages rounds upcoming results groups goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers fixtures

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

 "data": [
        {
            "id": 5307,
            "name": "2005/2006",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5308,
            "name": "2006/2007",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5309,
            "name": "2007/2008",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5310,
            "name": "2008/2009",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5311,
            "name": "2009/2010",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5312,
            "name": "2010/2011",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5313,
            "name": "2011/2012",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5318,
            "name": "2012/2013",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5315,
            "name": "2013/2014",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5322,
            "name": "2014/2015",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5321,
            "name": "2015/2016",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 718,
            "name": "2016/2017",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },

GET Season by ID

`GET` Season by ID

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

Parameters

Include options

league stages rounds upcoming results groups goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers fixtures

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/seasons/18346/api_token={API_TOKEN}

"data": {
        "id": 18346,
        "name": "2021/2022",
        "league_id": 2,
        "is_current_season": true,
        "current_round_id": null,
        "current_stage_id": 77453623
    }

Check this endpoint in Postman.

GET All Seasons

`GET` All Seasons

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

Parameters

Include options

league stages rounds upcoming results groups goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers fixtures

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

 "data": [
        {
            "id": 5307,
            "name": "2005/2006",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5308,
            "name": "2006/2007",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5309,
            "name": "2007/2008",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5310,
            "name": "2008/2009",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5311,
            "name": "2009/2010",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5312,
            "name": "2010/2011",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5313,
            "name": "2011/2012",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5318,
            "name": "2012/2013",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5315,
            "name": "2013/2014",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5322,
            "name": "2014/2015",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 5321,
            "name": "2015/2016",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },
        {
            "id": 718,
            "name": "2016/2017",
            "league_id": 2,
            "is_current_season": false,
            "current_round_id": null,
            "current_stage_id": null
        },

Check this endpoint in Postman.

GET Season by ID

`GET` Season by ID

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

Parameters

Include options

league stages rounds upcoming results groups goalscorers cardscorers assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers fixtures

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/seasons/18346/api_token={API_TOKEN}

"data": {
        "id": 18346,
        "name": "2021/2022",
        "league_id": 2,
        "is_current_season": true,
        "current_round_id": null,
        "current_stage_id": 77453623
    }

Check this endpoint in Postman.