Qodex.ai

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

KeyDatatypeRequiredDescription
includenullEnrich the API with more data and/or nested includes
pagenullThe 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":{}}}}