---
title: "List seasons for NFL"
method: GET
path: "/api/v1/nfl/seasons"
tags: ["NFL"]
---

# List seasons for NFL

`GET /api/v1/nfl/seasons`

## Request

- Base URL: `https://api.stat-api.com`
- URL: `https://api.stat-api.com/api/v1/nfl/seasons`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

seasons rows matching the declared filter set.

- NFLSeasonsListResponse
  - `has_more` boolean, required: True when a full page came back, so more rows can exist.
  - `limit` integer, required: Page size used for this response.
  - `next_from_id` integer, nullable, required: Pass this as `from_id` on the next request to page forward. `null` on the terminal page, and on a first page requested without `from_id` (that page uses the default sort): to walk every row, start with `from_id=0`.
  - `seasons` NFLSeasons[], required
    - `end_date` string, date-time, nullable: Last day of the season (Super Bowl date or shortly after).
    - `id` integer, required: Primary Key
    - `post_season_start_date` string, date-time, nullable: First day of the postseason (Wild Card weekend).
    - `regular_season_start_date` string, date-time, nullable: First day of regular-season play (typically the Thursday after Labor Day).
    - `regular_season_weeks` integer, required: Number of regular-season weeks (18 since 2021; 17 in 2020 and earlier).
    - `start_date` string, date-time, required: First day of the season (typically the start of preseason in early August).
    - `start_year` integer, required: Calendar year in which the season starts (e.g., 2025 = the 2025-26 season).
    - `super_bowl_date` string, date-time, nullable: Date of the Super Bowl for this season.

## Other responses

- `400`: No declared filter set was satisfied by the request — see `accepted` in the body for the valid combinations.

---

[API](https://skmtc.dev/stat-api/apis/sports-db-public-api.md) · [All operations](https://skmtc.dev/stat-api/apis/sports-db-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stat-api/apis/sports-db-public-api/revisions/23b66b957723?raw)