seasonsnfl.seasons

Each NFL league year, from the opening of training camp through the Super Bowl. The 2025 season refers to the 2025-26 league year, kicking off in early August and ending in February.

Full field reference (8 columns) → Data Dictionary Query in GraphQL →

GET/api/v1/nfl/seasonsList seasons for NFL

Parameters

limitqueryintegeroptionaldefault 25

Page size. Defaults to 25; max 5000.

from_idquerybigintoptional

Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.

Restores the documented defaults (trial keys only accept the unchanged defaults).

Request

curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/seasons?limit=3'

Responses

200seasons rows matching the declared filter set, wrapped in { seasons, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸

400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json

Response Schema(8 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
end_date	timestamptznullable	—	Last day of the season (Super Bowl date or shortly after). e.g. 2020-02-02T05:00:00.000Z
post_season_start_date	timestamptznullable	—	First day of the postseason (Wild Card weekend). e.g. 2020-01-04T05:00:00.000Z
regular_season_start_date	timestamptznullable	—	First day of regular-season play (typically the Thursday after Labor Day). e.g. 2019-09-05T04:00:00.000Z
regular_season_weeks	integer	—	Number of regular-season weeks (18 since 2021; 17 in 2020 and earlier). e.g. 18
start_date	timestamptz	—	First day of the season (typically the start of preseason in early August). e.g. 2019-09-05T04:00:00.000Z
start_year	integer	—	Calendar year in which the season starts (e.g., 2025 = the 2025-26 season). e.g. 2019
super_bowl_date	timestamptznullable	—	Date of the Super Bowl for this season. e.g. 2020-02-02T05:00:00.000Z

GET/api/v1/nfl/seasons/{id}Get a single season by id

Parameters

idpathbigintrequired

Primary key (id) of the season row.

Restores the documented defaults (trial keys only accept the unchanged defaults).

Request

curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/seasons/{pk_value}'

Responses

200Single season row.application/jsonshow example ▸

404Row not found.

Response Schema(8 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
end_date	timestamptznullable	—	Last day of the season (Super Bowl date or shortly after). e.g. 2020-02-02T05:00:00.000Z
post_season_start_date	timestamptznullable	—	First day of the postseason (Wild Card weekend). e.g. 2020-01-04T05:00:00.000Z
regular_season_start_date	timestamptznullable	—	First day of regular-season play (typically the Thursday after Labor Day). e.g. 2019-09-05T04:00:00.000Z
regular_season_weeks	integer	—	Number of regular-season weeks (18 since 2021; 17 in 2020 and earlier). e.g. 18
start_date	timestamptz	—	First day of the season (typically the start of preseason in early August). e.g. 2019-09-05T04:00:00.000Z
start_year	integer	—	Calendar year in which the season starts (e.g., 2025 = the 2025-26 season). e.g. 2019
super_bowl_date	timestamptznullable	—	Date of the Super Bowl for this season. e.g. 2020-02-02T05:00:00.000Z

GET/api/v1/nfl/contextCurrent NFL week and its DFS slates

Parameters

seasonqueryintegeroptional

Season start year (e.g. 2026). Without week, the current week of that season, else week 1.

weekqueryintegeroptional

Regular-season week, 1-18. Without season, the current season.

Restores the documented defaults (trial keys only accept the unchanged defaults).

Request

curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/context?season=1&week=1'

Responses

200Current NFL week and its DFS slatesapplication/jsonshow example ▸

Response Schema(21 fields)show schema ▸

Field	Type	References	Description
today	string	—	Today in US Eastern time (YYYY-MM-DD).
as_of	string	—	Server time of the answer (ISO 8601, UTC).
phase	string	—	preseason (before week 1), regular_season (inside a week window), postseason (after the last week until the last postseason game), or offseason.
current_season	integernullable	—	Season of the current week.
current_week	integernullable	—	Current regular-season week. Before week 1 it is week 1; after the last week it is the last week.
season	integernullable	—	Season of the described week (the current one unless season or week was passed).
week	integernullable	—	The described week.
start_date	stringnullable	—	First day of the week window (YYYY-MM-DD, US Eastern).
end_date	stringnullable	—	Last day of the week window, the week's last game day (YYYY-MM-DD, US Eastern).
games	bigint	—	Regular-season games in the week.
games_final	bigint	—	Games with status Final.
games_live	bigint	—	Games that have kicked off and are not Final.
games_upcoming	bigint	—	Games that have not kicked off.
first_kickoff	stringnullable	—	First kickoff of the week (ISO 8601, UTC).
next_kickoff	stringnullable	—	Next kickoff after now in the week (ISO 8601, UTC); null once every game has started.
last_kickoff	stringnullable	—	Last kickoff of the week (ISO 8601, UTC).
slates	list	—	The week's DFS slates, largest total prize money first.
↳slate_id slates[].slate_id	bigint	—	dfs.slates id.
↳operator slates[].operator	string	—	DraftKings or FanDuel.
↳name slates[].name	stringnullable	—	Slate name.
↳game_type slates[].game_type	stringnullable	—	classic, showdown, single_game or tiers (from the slate setting).
↳main slates[].main	boolean	—	The operator's featured slate for the day.
↳start_time slates[].start_time	stringnullable	—	Lock time (ISO 8601, UTC).
↳status slates[].status	stringnullable	—	Upcoming, Live or Completed.
↳contest_count slates[].contest_count	bigint	—	Contests on the slate (not cancelled).
↳prize_pool_total slates[].prize_pool_total	bigint	—	Sum of the contests' prize pools, in cents.
↳largest_contest_id slates[].largest_contest_id	bigintnullable	—	dfs.contests id of the largest contest (prize pool, then entries).
↳largest_contest_name slates[].largest_contest_name	stringnullable	—	Name of the largest contest.
↳largest_contest_prize_pool slates[].largest_contest_prize_pool	bigintnullable	—	Prize pool of the largest contest, in cents.
flagships	object	—	The described week's flagship contest per operator (custom/dfs/flagship.rs): DraftKings' main-slate Millionaire with the most entries, FanDuel's main-slate Sunday Million with the most entries (satellites never count). Null until the contest has a lineup capsule; never a substitute.
↳draftkings flagships.draftkings	objectnullable	—	DraftKings: the week's flagship, or null until it has a lineup capsule.
↳operator flagships.draftkings.operator	string	—	draftkings or fanduel.
↳season flagships.draftkings.season	integer	—	Season start year of the week.
↳week flagships.draftkings.week	integer	—	Regular-season week.
↳sunday flagships.draftkings.sunday	string	—	The week's game Sunday in US Eastern time (YYYY-MM-DD): the main slate's date.
↳slate_id flagships.draftkings.slate_id	bigint	—	The operator's main NFL slate that Sunday.
↳slate_name flagships.draftkings.slate_name	stringnullable	—	That slate's name.
↳contest_id flagships.draftkings.contest_id	bigint	—	The flagship contest (open it in /api/v1/dfs/contests/{contest_id}/standings).
↳name flagships.draftkings.name	string	—	The contest's name.
↳entries flagships.draftkings.entries	bigint	—	The contest's entries.
↳entry_fee_cents flagships.draftkings.entry_fee_cents	bigint	—	Entry fee in cents.
↳prize_pool_cents flagships.draftkings.prize_pool_cents	bigint	—	Prize pool in cents.
↳free flagships.draftkings.free	boolean	—	True when anyone may read the contest's top 100 entries without a key (season 2026 and later, FREE_FLAGSHIP_FROM_SEASON). False in the 2021-2025 archive, the Pro product.
↳fanduel flagships.fanduel	objectnullable	—	FanDuel: the week's flagship, or null until it has a lineup capsule.
↳operator flagships.fanduel.operator	string	—	draftkings or fanduel.
↳season flagships.fanduel.season	integer	—	Season start year of the week.
↳week flagships.fanduel.week	integer	—	Regular-season week.
↳sunday flagships.fanduel.sunday	string	—	The week's game Sunday in US Eastern time (YYYY-MM-DD): the main slate's date.
↳slate_id flagships.fanduel.slate_id	bigint	—	The operator's main NFL slate that Sunday.
↳slate_name flagships.fanduel.slate_name	stringnullable	—	That slate's name.
↳contest_id flagships.fanduel.contest_id	bigint	—	The flagship contest (open it in /api/v1/dfs/contests/{contest_id}/standings).
↳name flagships.fanduel.name	string	—	The contest's name.
↳entries flagships.fanduel.entries	bigint	—	The contest's entries.
↳entry_fee_cents flagships.fanduel.entry_fee_cents	bigint	—	Entry fee in cents.
↳prize_pool_cents flagships.fanduel.prize_pool_cents	bigint	—	Prize pool in cents.
↳free flagships.fanduel.free	boolean	—	True when anyone may read the contest's top 100 entries without a key (season 2026 and later, FREE_FLAGSHIP_FROM_SEASON). False in the 2021-2025 archive, the Pro product.
flagships_latest	object	—	Per operator, the most recent week (game Sunday on or before today) whose flagship has a lineup capsule and is free: the contest the Contest Analysis tool opens for a visitor with no key.
↳draftkings flagships_latest.draftkings	objectnullable	—	DraftKings: the latest free flagship with a capsule, or null.
↳operator flagships_latest.draftkings.operator	string	—	draftkings or fanduel.
↳season flagships_latest.draftkings.season	integer	—	Season start year of the week.
↳week flagships_latest.draftkings.week	integer	—	Regular-season week.
↳sunday flagships_latest.draftkings.sunday	string	—	The week's game Sunday in US Eastern time (YYYY-MM-DD): the main slate's date.
↳slate_id flagships_latest.draftkings.slate_id	bigint	—	The operator's main NFL slate that Sunday.
↳slate_name flagships_latest.draftkings.slate_name	stringnullable	—	That slate's name.
↳contest_id flagships_latest.draftkings.contest_id	bigint	—	The flagship contest (open it in /api/v1/dfs/contests/{contest_id}/standings).
↳name flagships_latest.draftkings.name	string	—	The contest's name.
↳entries flagships_latest.draftkings.entries	bigint	—	The contest's entries.
↳entry_fee_cents flagships_latest.draftkings.entry_fee_cents	bigint	—	Entry fee in cents.
↳prize_pool_cents flagships_latest.draftkings.prize_pool_cents	bigint	—	Prize pool in cents.
↳free flagships_latest.draftkings.free	boolean	—	True when anyone may read the contest's top 100 entries without a key (season 2026 and later, FREE_FLAGSHIP_FROM_SEASON). False in the 2021-2025 archive, the Pro product.
↳fanduel flagships_latest.fanduel	objectnullable	—	FanDuel: the latest free flagship with a capsule, or null.
↳operator flagships_latest.fanduel.operator	string	—	draftkings or fanduel.
↳season flagships_latest.fanduel.season	integer	—	Season start year of the week.
↳week flagships_latest.fanduel.week	integer	—	Regular-season week.
↳sunday flagships_latest.fanduel.sunday	string	—	The week's game Sunday in US Eastern time (YYYY-MM-DD): the main slate's date.
↳slate_id flagships_latest.fanduel.slate_id	bigint	—	The operator's main NFL slate that Sunday.
↳slate_name flagships_latest.fanduel.slate_name	stringnullable	—	That slate's name.
↳contest_id flagships_latest.fanduel.contest_id	bigint	—	The flagship contest (open it in /api/v1/dfs/contests/{contest_id}/standings).
↳name flagships_latest.fanduel.name	string	—	The contest's name.
↳entries flagships_latest.fanduel.entries	bigint	—	The contest's entries.
↳entry_fee_cents flagships_latest.fanduel.entry_fee_cents	bigint	—	Entry fee in cents.
↳prize_pool_cents flagships_latest.fanduel.prize_pool_cents	bigint	—	Prize pool in cents.
↳free flagships_latest.fanduel.free	boolean	—	True when anyone may read the contest's top 100 entries without a key (season 2026 and later, FREE_FLAGSHIP_FROM_SEASON). False in the 2021-2025 archive, the Pro product.
primetime_slates	object	—	The described week's primetime games and their pre-game single-game slates (custom/dfs/primetime.rs): tnf = every game that kicks off on a Thursday (US Eastern), mnf = every game that kicks off on a Monday. A night can hold two games. A pre-game single-game slate has the slate setting's game type 1 and one game, and no in-game format; with two for one operator, the most contests wins. Open one in /api/v1/dfs/slates/{slate_id}/contest-ownership. Empty lists for a week without such games.
↳tnf primetime_slates.tnf	list	—	Thursday games, by kickoff.
↳game_id primetime_slates.tnf[].game_id	bigint	—	nfl.games id.
↳away primetime_slates.tnf[].away	stringnullable	—	Away team abbreviation.
↳home primetime_slates.tnf[].home	stringnullable	—	Home team abbreviation.
↳kickoff primetime_slates.tnf[].kickoff	stringnullable	—	Kickoff (ISO 8601, UTC).
↳draftkings_slate_id primetime_slates.tnf[].draftkings_slate_id	bigintnullable	—	The game's DraftKings pre-game Showdown slate (dfs.slates id; never an In-Game Showdown). Null until it exists.
↳fanduel_slate_id primetime_slates.tnf[].fanduel_slate_id	bigintnullable	—	The game's FanDuel pre-game single-game slate (dfs.slates id; never 2nd half or 4th quarter). Null until it exists.
↳mnf primetime_slates.mnf	list	—	Monday games, by kickoff.
↳game_id primetime_slates.mnf[].game_id	bigint	—	nfl.games id.
↳away primetime_slates.mnf[].away	stringnullable	—	Away team abbreviation.
↳home primetime_slates.mnf[].home	stringnullable	—	Home team abbreviation.
↳kickoff primetime_slates.mnf[].kickoff	stringnullable	—	Kickoff (ISO 8601, UTC).
↳draftkings_slate_id primetime_slates.mnf[].draftkings_slate_id	bigintnullable	—	The game's DraftKings pre-game Showdown slate (dfs.slates id; never an In-Game Showdown). Null until it exists.
↳fanduel_slate_id primetime_slates.mnf[].fanduel_slate_id	bigintnullable	—	The game's FanDuel pre-game single-game slate (dfs.slates id; never 2nd half or 4th quarter). Null until it exists.
primetime_flagships	object	—	The described week's single-game flagships (custom/dfs/flagship.rs, Frank 2026-10-01): per primetime night, the GUARANTEED contest with the biggest prize pool among the night's DraftKings pre-game Showdown slates (never an In-Game Showdown, never the most entries; no qualifier or satellite), null until it has a lineup capsule and never a substitute. tnf is the Thursday night (a week with no Thursday game: the Wednesday night), mnf the Monday night. A Wednesday opener in a week that also has a Thursday game is a single-game flagship too (top 10 open in Contest Analysis) but not in this block. These contests are top 10 open (access.plan top10_open) and stay out of flagships_latest.
↳tnf primetime_flagships.tnf	objectnullable	—	The Thursday night's single-game flagship, or null.
↳operator primetime_flagships.tnf.operator	string	—	draftkings.
↳season primetime_flagships.tnf.season	integer	—	Season start year of the week.
↳week primetime_flagships.tnf.week	integer	—	Regular-season week.
↳night primetime_flagships.tnf.night	string	—	tnf (a Thursday night, or a Wednesday night such as the week 1 opener) or mnf (a Monday night).
↳date primetime_flagships.tnf.date	string	—	The night's date in US Eastern time (YYYY-MM-DD).
↳slate_id primetime_flagships.tnf.slate_id	bigint	—	The DraftKings pre-game Showdown slate of the contest.
↳slate_name primetime_flagships.tnf.slate_name	stringnullable	—	That slate's name.
↳contest_id primetime_flagships.tnf.contest_id	bigint	—	The single-game flagship contest (open it in /api/v1/dfs/contests/{contest_id}/standings).
↳name primetime_flagships.tnf.name	string	—	The contest's name.
↳entries primetime_flagships.tnf.entries	bigint	—	The contest's entries.
↳entry_fee_cents primetime_flagships.tnf.entry_fee_cents	bigint	—	Entry fee in cents.
↳prize_pool_cents primetime_flagships.tnf.prize_pool_cents	bigint	—	Prize pool in cents.
↳winner primetime_flagships.tnf.winner	stringnullable	—	The username of standings row 1, once the API has built the contest's lineup index (null until then; the response is then not cached, so a later read names the winner).
↳free primetime_flagships.tnf.free	boolean	—	True when anyone may read the contest top 10 open without a key (season 2026 and later). False in the 2021-2025 archive, the Pro product.
↳mnf primetime_flagships.mnf	objectnullable	—	The Monday night's single-game flagship, or null.
↳operator primetime_flagships.mnf.operator	string	—	draftkings.
↳season primetime_flagships.mnf.season	integer	—	Season start year of the week.
↳week primetime_flagships.mnf.week	integer	—	Regular-season week.
↳night primetime_flagships.mnf.night	string	—	tnf (a Thursday night, or a Wednesday night such as the week 1 opener) or mnf (a Monday night).
↳date primetime_flagships.mnf.date	string	—	The night's date in US Eastern time (YYYY-MM-DD).
↳slate_id primetime_flagships.mnf.slate_id	bigint	—	The DraftKings pre-game Showdown slate of the contest.
↳slate_name primetime_flagships.mnf.slate_name	stringnullable	—	That slate's name.
↳contest_id primetime_flagships.mnf.contest_id	bigint	—	The single-game flagship contest (open it in /api/v1/dfs/contests/{contest_id}/standings).
↳name primetime_flagships.mnf.name	string	—	The contest's name.
↳entries primetime_flagships.mnf.entries	bigint	—	The contest's entries.
↳entry_fee_cents primetime_flagships.mnf.entry_fee_cents	bigint	—	Entry fee in cents.
↳prize_pool_cents primetime_flagships.mnf.prize_pool_cents	bigint	—	Prize pool in cents.
↳winner primetime_flagships.mnf.winner	stringnullable	—	The username of standings row 1, once the API has built the contest's lineup index (null until then; the response is then not cached, so a later read names the winner).
↳free primetime_flagships.mnf.free	boolean	—	True when anyone may read the contest top 10 open without a key (season 2026 and later). False in the 2021-2025 archive, the Pro product.