Integration GuidesDocs
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>Groups, Rounds, Seasons, & Stages:</u></b></summary>

<div class="smallfont">

| Attribute        | Parent Element | Type    | Description                                                                                        |
| ---------------- | -------------- | ------- | -------------------------------------------------------------------------------------------------- |
| `competition_id` | `season`       | String  | Unique ID for the competition a sport event belongs to<br>ex. `sr:competition:17` (Premier League) |
| `disabled`       | `season`       | Boolean | Signifies a season has been disabled when `true`                                                   |
| `end_date`       | `season`       | Date    | End date of a sport event's season<br>ex. `2024-05-19`                                             |
| `id`             | `season`       | String  | Unique ID for a sport event's season<br>ex. `sr:season:105353` (Premier League 23/24)              |
| `name`           | `season`       | String  | Name of a sport event's season<br>ex. `Premier League 23/24`                                       |
| `start_date`     | `season`       | Date    | Start date of a sport event's season<br>ex. `2023-08-11`                                           |
| `year`           | `season`       | String  | Year of a sport event's season<br>ex. `23/24`                                                      |

</div>
</details>

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