Season by ID

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

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

NO - 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 stage round fixtures

Request Params

KeyDatatypeRequiredDescription
includenullEnrich the API with more data and/or nested includes

RESPONSES

status: OK

{"data":{"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}]}}