# Seasons

Gather an overview of all the historical and current seasons available within your subscription. Responses provide you details like the Season ID, Name, League ID, Year and if the Season is Active Yes or No. 

{% hint style="info" %}
Are you interested in a complete schedule? Then maybe our schedule endpoints are what you’re looking for: [Schedule endpoint](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/schedules).
{% endhint %}

Use one of our 3 season endpoints. Per endpoint, you can find the details, including base URL, parameters, includes and more. 

* **GET All Seasons:** returns all the historical and active seasons that are available within your subscription. 
* **GET Season by ID:** returns the single-season you’ve requested by ID.
* **GET Seasons by Search by Name:** returns all seasons that match your search query.

### Include options

[`sport`](https://app.gitbook.com/o/-MJWE53IpT91aRTPjruo/s/z0kWjB5EvZvqGsozw8vP/) [`league`](https://docs.sportmonks.com/v3/entities/league-season-schedule-stage-and-round#league) [`teams`](https://docs.sportmonks.com/v3/entities/team-player-squad-coach-and-referee#team) [`stages`](https://docs.sportmonks.com/v3/entities/league-season-schedule-stage-and-round#stage) [`currentStage`](https://docs.sportmonks.com/v3/entities/league-season-schedule-stage-and-round#stage) [`fixtures`](https://docs.sportmonks.com/v3/entities/fixture#fixture) [`groups`](https://docs.sportmonks.com/v3/entities/league-season-schedule-stage-and-round#group) [`statistics`](https://docs.sportmonks.com/v3/entities/statistic#seasonstatistic) [`topscorers`](https://docs.sportmonks.com/v3/entities/standing-and-topscorer#topscorers)

### **Related Entities:**

Get an overview and explanation of all the fields returned in the API response. The related entities for the seasons endpoints are:

* [Season](https://docs.sportmonks.com/v3/entities/league-season-schedule-stage-and-round#season)

{% hint style="info" %}
Remember, our historical data will be integrated into the new version of our API gradually. So, the historical data is not yet complete. However, we will be loading more historical data continuously.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/seasons.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.