All Seasons
GET https://soccer.sportmonks.com/api/v2.0/seasons
Introduction
Responses of the Seasons endpoint are limited to Seasons of the Leagues available in the Plan you are subscribed to. Responses provide you details about for example 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.
Pagination
YES - Indicates if this endpoint contains pagination.
Nested Includes
2 - You can add a maximum of 2 levels of nested includes.
Includes Options
league stages rounds upcoming results groups goalscorers cardscorers
assistscorers aggregatedGoalscorers aggregatedCardscorers aggregatedAssistscorers fixtures
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
include | null | Enrich the API with more data and/or nested includes | |
page | null | The number of the page you want to browse. Can be used by adding &page=2 etc to your request url. |
RESPONSES
status: OK
{"data":[{"id":1273,"name":"2005/2006","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1274,"name":"2006/2007","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1275,"name":"2007/2008","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1276,"name":"2008/2009","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1277,"name":"2009/2010","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1278,"name":"2010/2011","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1279,"name":"2011/2012","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1280,"name":"2012/2013","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1281,"name":"2013/2014","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1282,"name":"2014/2015","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1286,"name":"2015/2016","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":759,"name":"2016/2017","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":6361,"name":"2017/2018","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":12919,"name":"2018/2019","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":16020,"name":"2019/2020","league_id":271,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":17328,"name":"2020/2021","league_id":271,"is_current_season":true,"current_round_id":199447,"current_stage_id":77447994},{"id":1927,"name":"2005/2006","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1928,"name":"2006/2007","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1929,"name":"2007/2008","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1930,"name":"2008/2009","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1931,"name":"2009/2010","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1932,"name":"2010/2011","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1933,"name":"2011/2012","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1934,"name":"2012/2013","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1935,"name":"2013/2014","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1936,"name":"2014/2015","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":1937,"name":"2015/2016","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":825,"name":"2016/2017","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":7953,"name":"2017/2018","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":12963,"name":"2018/2019","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":16222,"name":"2019/2020","league_id":501,"is_current_season":false,"current_round_id":null,"current_stage_id":null},{"id":17141,"name":"2020/2021","league_id":501,"is_current_season":true,"current_round_id":194969,"current_stage_id":77447501}],"meta":{"subscription":{"started_at":{"date":"2019-09-02 09:52:14.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":{"date":"2019-09-16 09:52:10.000000","timezone_type":3,"timezone":"UTC"},"ends_at":null},"plan":{"name":"PostMan Plan","price":"25.00","request_limit":"2000,60"},"sports":[{"id":1,"name":"Soccer","current":true}],"pagination":{"total":32,"count":32,"per_page":50,"current_page":1,"total_pages":1,"links":{}}}}