---
updatedAt: 2026-09-09T07:06:06.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/football/llms.txt
---

# Seasons

**NFL Seasons** provides a list of all available seasons, including preseasons and postseasons.

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

  **TTL / Cache:** 4 hours

  **Data Updates:** New seasons appear as they are added to the database

  **Recommended Pull (Non-Live):** Pull on an as-needed basis.

  **Recommended Pull (Live):** Not applicable
</Callout>

> 📘 Confirming Season Availability
>
> Learn how to use the Seasons feed to confirm available seasons before requesting downstream data in our <a href="https://developer.sportradar.com/football/docs/nfl-ig-schedules" target="_blank">Pulling Schedules</a> integration scenario.

***

## Data Points

<Accordion title="League" icon="fa-duotone fa-thin fa-football">
  | Attribute    | Parent Element    | Type    | Description                                                                 |
  | ------------ | ----------------- | ------- | --------------------------------------------------------------------------- |
  | `alias`      | `league`          | String  | Alias of a league<br /><br />ex. `NFL`                                      |
  | `id`         | `league`          | GUID    | Unique ID of a league<br /><br />ex. `3c6d318a-6164-4290-9bbc-bf9bb21cc4b8` |
  | `name`       | `league`          | String  | Name of a league<br /><br />ex. `National Football League`                  |
  | `id`         | `season`          | GUID    | Unique season ID<br /><br />ex. `75749c10-56c1-4ae0-9d1e-2689708debdf`      |
  | `code`       | `season` - `type` | String  | Type of the season<br /><br />`PRE`, `REG`, `PST`                           |
  | `year`       | `season`          | Integer | Year of the season                                                          |
  | `start_date` | `season`          | date    | Season start date<br /><br />ex. `2022-09-09`                               |
  | `end_date`   | `season`          | date    | Season end date<br /><br />ex. `2023-01-08`                                 |
  | `status`     | `season`          | String  | Season status<br /><br />`closed`, `inprogress`,`scheduled`                 |
</Accordion>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "nfl",
    "version": "7"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/nfl/official/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{access_level}/v7/{language_code}/league/seasons.{format}": {
      "get": {
        "summary": "Seasons",
        "description": "**NFL Seasons** provides a list of all available seasons, including preseasons and postseasons.",
        "operationId": "nfl-seasons",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`trial`, `production`",
            "schema": {
              "type": "string",
              "enum": [
                "trial",
                "production"
              ],
              "default": "trial"
            },
            "required": true
          },
          {
            "name": "language_code",
            "in": "path",
            "description": "2-letter code for supported languages<br><br>`br` (Brazilian Portuguese), `da` (Danish), `de` (German), `en` (English), `es` (Spanish), `fi` (Finnish), `fr` (French), `it` (Italian), `ja` (Japanese), `nl` (Dutch), `no` (Norwegian), `se` (Swedish), `tr` (Turkish)",
            "schema": {
              "type": "string",
              "enum": [
                "br",
                "da",
                "de",
                "en",
                "es",
                "fi",
                "fr",
                "it",
                "ja",
                "nl",
                "no",
                "se",
                "tr"
              ],
              "default": "en"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`json`, `xml`",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "xml"
              ],
              "default": "json"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"league\": {\n        \"id\": \"3c6d318a-6164-4290-9bbc-bf9bb21cc4b8\",\n        \"name\": \"National Football League\",\n        \"alias\": \"NFL\"\n    },\n    \"seasons\": [\n        {\n            \"id\": \"75749c10-56c1-4ae0-9d1e-2689708debdf\",\n            \"year\": 2022,\n            \"start_date\": \"2022-09-09\",\n            \"end_date\": \"2023-01-08\",\n            \"status\": \"inprogress\",\n            \"type\": {\n                \"code\": \"REG\"\n            }\n        }\n    ]\n}\n"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "league": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8"
                        },
                        "name": {
                          "type": "string",
                          "example": "National Football League"
                        },
                        "alias": {
                          "type": "string",
                          "example": "NFL"
                        }
                      }
                    },
                    "seasons": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "75749c10-56c1-4ae0-9d1e-2689708debdf"
                          },
                          "year": {
                            "type": "integer",
                            "example": 2022,
                            "default": 0
                          },
                          "start_date": {
                            "type": "string",
                            "example": "2022-09-09"
                          },
                          "end_date": {
                            "type": "string",
                            "example": "2023-01-08"
                          },
                          "status": {
                            "type": "string",
                            "example": "inprogress"
                          },
                          "type": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string",
                                "example": "REG"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```