Seasons

What Sportmonks provides

Sportmonks gives you access to complete season metadata for every league within your plan, covering both active and historical seasons. Each season record includes:

– Season name (for example, “2024/2025”)
– Start and end dates
– League association
– Whether the season is currently active (is_current)
– Current stage and round IDs
– Whether games are scheduled in the current week (games_in_current_week)

This metadata is the foundation for building any feature that requires scoping data to a specific competition year,  from fixture calendars to historical comparisons.

Endpoints

Sportmonks provides three seasons endpoints in Football API v3:

GET All Seasons returns all historical and active seasons available in your subscription. Useful for building a selector or evaluating which historical seasons are available and what their unique IDs are.

GET https://api.sportmonks.com/v3/football/seasons?api_token=YOUR_TOKEN

GET Season by ID returns a single season by its unique ID. This is the most common starting point when you already know which season you want to scope your requests to.

GET https://api.sportmonks.com/v3/football/seasons/{season_id}?api_token=YOUR_TOKEN

GET https://api.sportmonks.com/v3/football/seasons/search/{search_query}?api_token=YOUR_TOKEN

Enriching season data with includes

By default, a season request returns core metadata. You can enrich responses using includes to pull related data in a single request. Commonly used includes for seasons are fixtures, statistics, league, stages, and rounds. Nested includes are supported up to 3 levels deep, so, for example, you can include fixtures.participants to return team names alongside every fixture in the season.

Example request for a season with fixtures, statistics, and league details:

GET https://api.sportmonks.com/v3/football/seasons/19735?api_token=YOUR_TOKEN&include=fixtures;statistics;league

Filtering

The seasons endpoint supports both static and dynamic filters. A particularly useful filter for live applications is currentSeasons, which limits results to only active seasons. This is helpful when pulling player or team data, and you only want to surface current-season performance rather than all historical records:

GET https://api.sportmonks.com/v3/football/players?api_token=YOUR_TOKEN&include=statistics&filters=currentSeasons:playerStatistic

What you can build with season data

– Fixture calendars scope all fixtures to an active season to display a complete match schedule.
– League tables standings are always tied to a season, so the active season ID is your entry point for any live league table.
– Player and team statistics are season-level stats, power performance dashboards, and year-on-year comparisons.
– Historical features are used to access past seasons to build head-to-head history tools, form guides, and trend analysis.
– Prediction and fantasy tools give season context, which is essential for models that rely on historical performance patterns.

Availability

Season data is included in all Starter, Growth, Pro, and Enterprise plans. All plans include the same professional-grade data ; the differences between plans are the number of leagues you can select and your hourly API call limit. Historical seasons older than 3 years are available via the historical data add-on, with a one-time fee of € 29. Enterprise plans include full historical access by default.

You can explore and test the seasons endpoints using the Postman collection or the API tester in MySportmonks. Full endpoint documentation is available in the Sportmonks Football API v3 docs.

Try it free; all paid plans include a 14-day free trial, and the forever-free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.