GET All Seasons

GET All Seasons

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

Endpoint details
Authorization	API Key
Pagination	YES
Allowed nested includes	4

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.

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:

Includes

Example response

Request

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

Response

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

Field Description

Field	Description
data	Opens an array of data you've requested
id	The unique season id
name	The name of the season
league_id	The unique league id the season belongs to
is_current_season	Indicates if the season is the current one. Possible values are "true" or "false"
current_round_id	The unique id of the current round
current_stage_id	The unique id of the current stage

Check this endpoint in Postman.