Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Seasons

Global Football 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>Seasons:</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:31` (NFL) |
  | `disabled`       | `season`       | Boolean | Signifies a season has been disabled when `true`                                   |
  | `end_date`       | `season`       | Date    | End date of a season<br>ex. `2024-06-17`                                           |
  | `id`             | `season`       | String  | Unique ID for a season<br>ex. `sr:season:108577` (NFL 23/24)                       |
  | `name`           | `season`       | String  | Name of a season<br>ex. `NFL 23/24`                                                |
  | `start_date`     | `season`       | Date    | Start date of a season<br>ex. `2023-09-23`                                         |
  | `year`           | `season`       | String  | Year of a season<br>ex. `23/24`                                                    |

  </div>
</details>

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