Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Seasons

USFL Seasons provides a list of all available seasons in the API.

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

  **TTL / Cache:** 300 seconds

  **Data Updates**: As Necessary
</Callout>

***

<br />

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

<body>

## Data Points

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

  <div class="smallfont">

  | Attribute    | Parent Element    | Type    | Description                                                         |
  | ------------ | ----------------- | ------- | ------------------------------------------------------------------- |
  | `alias`      | `league`          | String  | Alias of a league<br>ex. `USFL`                                     |
  | `id`         | `league`          | GUID    | Unique ID of a league<br>ex. `df9ab8a5-fcf3-4da4-9c49-434c148999f8` |
  | `name`       | `league`          | String  | Name of a league<br>ex. `USFL`                                      |
  | `id`         | `season`          | GUID    | Unique season ID<br>ex. `234f28d6-b9d7-4881-a890-30b451c13aec`      |
  | `code`       | `season` - `type` | String  | Type of the season<br>`REG`, `PST`                                  |
  | `year`       | `season`          | Integer | Year of the season                                                  |
  | `start_date` | `season`          | date    | Season start date<br>ex. `2023-04-15`                               |
  | `end_date`   | `season`          | date    | Season end date<br>ex. `2023-06-18`                                 |
  | `status`     | `season`          | String  | Season status<br>`closed`, `inprogress`, `scheduled`                |

  </div>
</details>

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