Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Seasons

Provides a list of historical season information for all competitions. Competitions will return a maximum of three seasons of data, including current or newly created seasons.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  300s Time To Live / Cache
</Callout>

***

<br />

<html>
<head>
<style>
.smallfont a {
  font-size: 95%
}
div.smallfont {
  font-size: 82%;
}
</style>
</head>

<body>

## Data Points

<details>
<summary><b><u>Season:</u></b></summary>

<div class="smallfont">

| Attribute        | Parent Element | Type    | Description                                                                                   |
| ---------------- | -------------- | ------- | --------------------------------------------------------------------------------------------- |
| `competition_id` | `season`       | String  | Unique ID for the competition a season belongs to<br>ex. `sr:competition:548` (Olympic Games) |
| `disabled`       | `season`       | Boolean | Signifies a season has been disabled when `true`                                              |
| `end_date`       | `season`       | Date    | End date of a season<br>ex. `2025-03-17`                                                      |
| `id`             | `season`       | String  | Unique ID for a season<br>ex. `sr:season:121299` (Olympic Games 2024)                         |
| `name`           | `season`       | String  | Name of a season<br>ex. `Olympic Games 2024`                                                  |
| `start_date`     | `season`       | Date    | Start date of a season<br>ex. `2024-10-25`                                                    |
| `year`           | `season`       | String  | Year of a season<br>ex. `24/25` or `2025`                                                     |

</div>
</details>

</body>
</html>
Language
Credentials
Header
Click Try It! to start a request and see the response here!