National Football League

NFL API. Every play, in order, and still right after replay changes a call.

Scores, play-by-play, drives, box scores, game rosters and the injury report for every NFL game. Read it over REST, or stream every change over one WebSocket and resume by seq after a disconnect.

Alias
nfl
Status
Live
REST
from $19 a month
WebSocket
from $49 a month

Sample game

Bills 23 at Vikings 6. Monday Night Football, November 9, 2026.

These are untrimmed responses from the real API for one NFL game, free to download without a key. The game was replayed through Statpad's ingest into a fresh database, so the ids and every updated_at are from that run.

This game was recorded every 3 seconds from before kickoff to after the final, so it has a whole journal: 1,277 changes you can replay through your own client, plus a snapshot from the 4th quarter.

An app that replaces each play by id stays right through the whole game. 83 of its 270 play changes are newer versions of a play that had already arrived: a second tackler added, a touchdown that gains its extra point, a first-quarter penalty noted after the final whistle.

Its play-by-play has 187 plays:

  • pass 68
  • rush 51
  • timeout 21
  • penalty 11
  • punt 10
  • kickoff 9
  • other 7
  • field_goal 5

Built on this game: Ask Claude about an NFL game while it replays on your laptop, A live NFL scoreboard in SwiftUI, and the small server that holds the key and A fantasy football scoreboard for your Discord channel.

GET /v1/nfl/games/{id} · live_stateFull file
{
  "away_score": 13,
  "basketball": null,
  "clock_running": null,
  "clock_seconds": 422,
  "football": {
    "away_timeouts": 3,
    "down": 1,
    "home_timeouts": 2,
    "yardline": 95,
    "yards_to_go": 5
  },
  "game_id": "01a1d60f-67be-7bdd-83f4-53286521d9bb",
  "home_score": 6,
  "last_play_id": "01a1d60f-8d90-7a74-8905-46b0dc0d2751",
  "period": 4,
  "period_half": null,
  "possession_team_id": "01a1d60f-67be-7bdf-ac2f-bcdeeac1da68",
  "soccer": null,
  "updated_at": "2026-11-13T17:58:25.937181Z",
  "version": 264
}

live_state at seq 1101, with 7:02 left in the 4th quarter: Bills ball, 1st and goal at the Minnesota 5, up 13 to 6.

GET /v1/nfl/games/{id}/plays · one playFull file
{
  "away_score": 20,
  "basketball": null,
  "clock_seconds": 377,
  "description": "J.Cook up the middle for 5 yards, TOUCHDOWN. T.Bass extra point is GOOD, Center-R.Ferguson, Holder-T.Doman.",
  "football": {
    "air_yards": null,
    "down": 1,
    "end_yardline": 100,
    "is_first_down": false,
    "is_penalty": false,
    "is_touchdown": true,
    "is_turnover": false,
    "penalty_yards": null,
    "play_action": null,
    "play_type": "rush",
    "run_pass_option": null,
    "screen_pass": null,
    "start_yardline": 95,
    "yards_gained": 5,
    "yards_to_go": 5
  },
  "game_id": "01a1d60f-67be-7bdd-83f4-53286521d9bb",
  "group_id": "01a1d60f-891f-776a-b25f-34c39b445b1b",
  "home_score": 6,
  "id": "01a1d60f-a829-759c-a632-7e6eca90b7f0",
  "is_official": true,
  "is_scoring": true,
  "participants": [],
  "period": 4,
  "period_half": null,
  "points": 7,
  "sequence": 369800000,
  "soccer": null,
  "team_id": "01a1d60f-67be-7bdf-ac2f-bcdeeac1da68",
  "type": "rush",
  "updated_at": "2026-11-13T17:58:32.808887Z",
  "version": 2,
  "wall_clock": "2026-11-10T04:04:23Z"
}

James Cook's touchdown first arrived at seq 1106. At seq 1111 it arrived again as version 2, with the extra point. The plays endpoint returns the newest version.

GET /v1/nfl/games/{id}/boxscore · one playerFull file
{
  "game_id": "01a1d60f-67be-7bdd-83f4-53286521d9bb",
  "player_id": "01a1d60f-6a68-7e3c-b977-32d574ae17cf",
  "stats": {
    "fumbles": {
      "lost": 1,
      "fumbles": 1,
      "recovered": 0
    },
    "passing": {
      "att": 31,
      "sacks": 4,
      "yards": 234,
      "rating": 87.3,
      "touchdowns": 1,
      "completions": 21,
      "interceptions": 1,
      "sack_yards_lost": 29,
      "yards_per_attempt": 7.5
    },
    "rushing": {
      "att": 6,
      "yards": 15,
      "longest": 7,
      "touchdowns": 0,
      "yards_per_attempt": 2.5
    }
  },
  "team_id": "01a1d60f-67be-7bdf-ac2f-bcdeeac1da68",
  "version": 46
}

Josh Allen's line in the box score. A player only has the categories that apply to them.

Endpoints

REST at https://api.statpad.dev and one WebSocket at wss://stream.statpad.dev/v1/stream. Every league uses the same paths and JSON, so changing nfl to another alias keeps your parser working.

Request or streamWhat it returns
GET /v1/nfl/games?date=2026-11-10A day's games with status, start time and score. Pass from and to instead for a range of up to 31 days.
GET /v1/nfl/games/{id}One game with its teams, venue and live state
GET /v1/nfl/games/{id}/playsEvery play, in game order
GET /v1/nfl/games/{id}/play-groupsEvery drive, with yards, time of possession and result
GET /v1/nfl/games/{id}/boxscoreA stat line for each player
GET /v1/nfl/games/{id}/rosterThe players in the game, with team and jersey
GET /v1/nfl/games/{id}/changes?after_seq=0Every change after a seq: the same journal the stream sends
GET /v1/nfl/injuriesThe current injury report
GET /v1/nfl/teamsThe league's teams
game:<id>WebSocket stream for one game: the game, its live state, plays, stats and roster, in seq order
league:nflWebSocket stream for what the league's games share: teams, players and venues, plus injuries

A client that reconnects to the stream with the last seq it saw gets exactly the changes it missed. The API reference has every parameter and schema.

What every NFL game has

From Coverage by league. Everything but injuries comes from the live game feed and updates during the game.

DataWhereNFL
ScheduleGET /v1/{league}/gamesEvery game the league has published with both teams known, through the end of its season, with status, start time and score
Live statelive_state on GET /games/{id}Period, clock, score, possession, down, distance, yard line and timeouts. After the final, the last down, distance and yard line stay, and timeouts are null because the feed stops reporting them.
Game timingstarted_at, ended_at on the game; last_play_id on the live stateWhen the first play happened and, once the game is over, the last one, from the play-by-play's own clock; the newest play of any type, timeouts and period ends included
Play-by-playGET /games/{id}/playsEvery play: type, description, down and distance, start and end yard line, yards gained, penalty yards, first down, touchdown, turnover, score after the play, and the players involved with their roles. NFL passes that are completed also have air_yards: how far past the line of scrimmage the receiver caught the ball, negative behind it. It's null on incompletions, on every other play and in NCAAF, whose feed has no yards after the catch. A player the game's box score doesn't list, such as a long snapper, is left out of participants. On a live game a play can arrive with an empty or partial list and fill in on a later version.
DrivesGET /games/{id}/play-groupsEvery drive: plays, yards, first downs, start and end yard line, time of possession, result and points
Player box scoreplayers in GET /games/{id}/boxscorePassing, rushing, receiving, defense, interceptions, fumbles, kicking, punting, kick returns and punt returns
Game rosterGET /games/{id}/rosterThe players with a box-score line, with team and jersey
InjuriesGET /v1/nfl/injuriesEvery player on a team's injury report, refreshed every 30 minutes, with status (questionable, doubtful, out or injured_reserve), when it was reported and started_on (the US Eastern day of the first report Statpad recorded, not when the player was hurt), plus body part, side and estimated return when they're known. An injury that ends arrives on the stream as a delete.
Teams, players and venues/teams, /players/{id}Every team and player that has appeared in a game
Change journalGET /games/{id}/changes and the streamYes
  • Drives come from GET /games/{id}/play-groups, and every play carries the group_id of its drive.
  • The sample game was recorded before football plays listed their players, so its plays have an empty participants list and the description names them. Live NFL plays list theirs.

Box score stat codes in this game

CategoryCodes
kick_returnsyards, longest, returns, touchdowns, yards_per_return
punt_returnsyards, longest, returns, touchdowns, yards_per_return
defensivesacks, qb_hits, tackles, touchdowns, solo_tackles, passes_defended, tackles_for_loss
receivingyards, longest, targets, receptions, touchdowns, yards_per_reception
rushingatt, yards, longest, touchdowns, yards_per_attempt
fumbleslost, fumbles, recovered
passingatt, sacks, yards, rating, touchdowns, completions, interceptions, sack_yards_lost, yards_per_attempt
puntingpunts, yards, longest, inside_20, touchbacks, gross_average
interceptionsyards, touchdowns, interceptions
kickingpoints, field_goal_pct, field_goals_made, extra_points_made, longest_field_goal, field_goal_attempts, extra_point_attempts

A player only has the categories and codes that apply to them, so treat every code as optional.

Not filled yet

These endpoints and fields are part of the API, but nothing fills them for NFL today. Code written against them keeps working when the data arrives.

DataWhereWhat you get today
Team totalsteams in the box scoreAn empty list. Add up the player lines for team totals.
Score by periodperiod_scores on the game and the box scoreAn empty list. Plays carry the score after each play.
Team rostersGET /teams/{id}/rosterAn empty list. A game's roster lists the players in that game.
Depth chartsGET /teams/{id}/depth-chart404
Injury practice status and notespractice_status and comment on an injurynull
TransactionsGET /{league}/transactions?since=An empty list
Season stats and leadersGET /players/{id}/stats, GET /seasons/{year}/{type}/leadersEmpty lists
Football play tagsplay_action, screen_pass, run_pass_optionDeprecated and always null: no provider reports them. They stay in the response so existing parsers keep working.
Running clockclock_running on the live statenull: the football feed has no running flag, and its clock moves only when a play posts. Use status and clock_seconds.
Player detailsbirth_date, height_in, weight_lb, college and draft on playersnull
Football player positionsprimary_position on players (NFL players who have been on the injury report have it), and position and starter on a game roster entrynull, and starter is always false

History, and staying right

Statpad started collecting each league in November 2026 and doesn't backfill earlier games or seasons. Once collected, a game's plays, box score and roster stay readable over REST for good, and its change journal for at least 7 days after it ends.

A play or stat line can change after it first appears, during the game and shortly after it. The newer version arrives as an upsert with a higher version, on the same stream and in the same seq order as everything else. Key what you store by id and keep the highest version, and your app shows the current data with no special handling.

Pricing

Every plan includes all 10 leagues and every REST endpoint. Plans differ in volume, streaming and keys, and the limits are hard caps with no overage.

Compare every limit
  • Developer

    $19 a month

    • 25,000 requests a month
    • 1 request a second, burst of 10
    • REST only, no WebSocket
  • Pro

    $49 a month

    • 150,000 requests a month
    • 10 requests a second, burst of 30
    • WebSocket: 5 connections, 20 subscriptions
  • Business

    $299 a month

    • 2,000,000 requests a month
    • 25 requests a second, burst of 100
    • WebSocket: 10 connections, 150 subscriptions