V1 · LIVE

Data Coverage

What's in the database, how far back it goes, and where the gaps are.

Overview

GET /v1/meta · GET /v1/health

nfldata.org combines several public NFL data sources — nflverse, Pro-Football-Reference, FiveThirtyEight, and others — into one normalized schema. Coverage varies by dataset: games and final scores go back to , while play-by-play, advanced stats, and betting data generally start in 1999 or later. The table below breaks down what's available for each part of the database, with current row counts.

–
Season range (games)
—
Games
—
Players all-time
—
Plays (1999–present)
0
Teams (incl. defunct codes)

Games & Schedules

GET /v1/games
Dataset Coverage Rows Notes
Game results & box scores 1970– 2000 missing — Final scores, dates, and a Pro-Football-Reference box score link for every game back to 1970. The 2000 season is missing from the source and isn't recoverable from this pipeline.
Stadium, weather, betting lines, refs, coaches 1999– — Roof/surface/temp/wind, spread & total lines, moneylines, rest days, starting QBs, coaches, and officiating crews are only populated for 1999+. Pre-1999 rows leave these fields null.
Scoring-play summaries 1970–1997 — One row per scoring play (TD/FG/safety etc.) for pre-1999 games — coarser than full play-by-play. GET /v1/games/scoring.
Officiating crews 2015– — Per-game officiating assignments by role.

Play-by-Play

GET /v1/plays
Dataset Coverage Rows Notes
Every play (EPA/WPA, down & distance, etc.) 1999–2025 — No pre-1999 play-by-play exists publicly, so this is the earliest possible start.
Pass / rush / kick play splits 1999–2025 — / — / — Convenience views over fact_plays filtered & widened by play type.
Tracking-data participation (personnel, formations) 2016–2025 — Offense/defense personnel groupings, pass rush counts, coverage type.
FTN charting (route, motion, blitz tags) 2022–2025 — Manually charted play attributes not derivable from the box score.

Players & Stats

GET /v1/players · GET /v1/stats/*
Dataset Coverage Rows Notes
Player bios & IDs All-time — Every player with a known nflverse ID, with cross-source name matching (name_resolution: — mappings).
Game-by-game stat lines 1999–2024 — Passing/rushing/receiving/defense/kicking, one row per player per game. 2025 not yet published upstream.
Season stat totals 1999–2025 — GET /v1/stats/season — REG, POST, and combined REG+POST rows per player-season.
Next Gen Stats (passing/receiving/rushing) 2016–2025 — / — / — Tracking-derived metrics (CPOE, time to throw, separation, etc.) — only exist from 2016 on.
PFR advanced stats (season totals) Varies, recent seasons — / — / — / — Pass/rush/rec/def advanced metrics (pressure rate, broken tackles, etc.), season-level only.
QBR (season & weekly) Recent seasons — / — ESPN Total QBR.

Rosters & Personnel

GET /v1/rosters · GET /v1/teams/*
Dataset Coverage Rows Notes
Season rosters 1920– — Full historical roster data, including pre-1999 players (some without a modern player ID).
Weekly rosters 2002–2025 — Active/inactive status by week.
Depth charts 2001–2024 — Listed depth-chart position by week.
Snap counts 2013–2025 — Offensive/defensive/special teams snap percentages by game.
Injury reports 2009–2025 — Weekly injury report status (Questionable/Out/etc.).

Draft, Combine, Contracts & Trades

GET /v1/draft · GET /v1/combine · GET /v1/contracts · GET /v1/trades
Dataset Coverage Rows Notes
Draft picks 1980– — Every pick by round/team, linked to the player's modern ID where resolvable.
Combine results 2000– — Height/weight/40-time/etc. for drafted and undrafted invitees.
Contracts ~1991– — Contract value, APY, guarantees, and salary-cap percentage (nominal and inflation-adjusted).
Trades 2002– — Player and draft-pick trades between teams.

Teams & Ratings

GET /v1/teams · GET /v1/teams/elo
Dataset Coverage Rows Notes
Team reference (names, colors, logos) — — Includes current franchises plus legacy codes used by pre-1999 games (e.g. SLC, PHX, RAI) — see Games coverage above.
FiveThirtyEight Elo / QB-Elo ratings 1920–2022 — Pre- and post-game Elo and QB-adjusted Elo ratings for every game back to 1920.

Row counts last refreshed: unknown. See the API docs for full endpoint & field reference.

LIVE
NFL DATA — 100+ SEASONS OF HISTORY ◆ TEAM, PLAYER, AND PLAY-LEVEL STATS ◆ HEAD-TO-HEAD MATCHUP EXPLORER ◆ ERA-ADJUSTED COMPARISONS ◆ FREE PUBLIC API AT API.NFLDATA.ORG  ◆   NFL DATA — 100+ SEASONS OF HISTORY ◆ TEAM, PLAYER, AND PLAY-LEVEL STATS ◆ HEAD-TO-HEAD MATCHUP EXPLORER ◆ ERA-ADJUSTED COMPARISONS ◆ FREE PUBLIC API AT API.NFLDATA.ORG  ◆