National Hockey League

NHL API. Strength, penalties and rink position on every play.

Scores, play-by-play, skater and goalie box scores, game rosters and the injury report for every NHL game. Read it over REST, or stream every change over one WebSocket and resume by seq.

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

Sample game

Panthers 3 at Capitals 4. November 7, 2026.

These are untrimmed responses from the real API for one NHL 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.

A finished game with 333 plays: faceoffs, shots, hits, giveaways, takeaways, penalties and goals, each with the players involved.

The files are the exact bodies the API returned after the final, untrimmed.

Its play-by-play has 333 entries:

  • faceoff 56
  • shot_on_goal 53
  • stoppage 49
  • giveaway 40
  • hit 39
  • blocked_shot 31
  • missed_shot 28
  • takeaway 13
GET /v1/nhl/games/{id}/plays · one playFull file
{
  "away_score": 2,
  "basketball": null,
  "clock_seconds": 600,
  "description": "Brady Tkachuk Goal (10) Snap Shot, assists: Matthew Tkachuk (20), Seth Jones (17)",
  "football": null,
  "game_id": "01a1e5f6-713e-7a47-b1d5-dbb74e828b61",
  "group_id": null,
  "hockey": {
    "is_empty_net": false,
    "is_shootout": false,
    "penalty_minutes": null,
    "penalty_severity": null,
    "play_type": "goal",
    "rink_x": 88,
    "rink_y": -4,
    "shot_type": "snap",
    "strength": "power_play"
  },
  "home_score": 1,
  "id": "01a1e5f6-713e-7bfc-b8b7-a1a44802e38e",
  "is_official": true,
  "is_scoring": true,
  "participants": [
    {
      "player_id": "01a1e5f6-713e-7a7c-9d19-62cfca700356",
      "role": "assist",
      "team_id": "01a1e5f6-713e-7a52-920b-26f20525ffbc"
    },
    {
      "player_id": "01a1e5f6-713e-7a98-a3f0-5befc2db1da5",
      "role": "assist",
      "team_id": "01a1e5f6-713e-7a52-920b-26f20525ffbc"
    },
    {
      "player_id": "01a1e5f6-713e-7a80-8ad5-9ba4f7e298d0",
      "role": "scorer",
      "team_id": "01a1e5f6-713e-7a52-920b-26f20525ffbc"
    }
  ],
  "period": 1,
  "period_half": null,
  "points": 1,
  "sequence": 10600000000063,
  "soccer": null,
  "team_id": "01a1e5f6-713e-7a52-920b-26f20525ffbc",
  "type": "goal",
  "updated_at": "2026-11-16T20:04:55.740953Z",
  "version": 1,
  "wall_clock": "2026-11-07T18:00:55Z"
}

A power-play goal. A hockey play carries strength, shot_type, rink_x and rink_y, is_empty_net and is_shootout, and penalties add minutes and severity.

GET /v1/nhl/games/{id}/boxscore · one playerFull file
{
  "game_id": "01a1e5f6-713e-7a47-b1d5-dbb74e828b61",
  "player_id": "01a1e5f6-713e-7aa4-b930-95f351f904f5",
  "stats": {
    "goalies": {
      "saves": 27,
      "save_pct": 0.871,
      "time_on_ice": 3539,
      "goals_against": 4,
      "shots_against": 31,
      "shootout_saves": 0,
      "penalty_minutes": 0,
      "power_play_saves": 5,
      "short_handed_saves": 2,
      "even_strength_saves": 20,
      "shootout_shots_against": 0
    }
  },
  "team_id": "01a1e5f6-713e-7a52-920b-26f20525ffbc",
  "version": 1
}

Akira Schmid's goalie line. Skaters have their own category, with time on ice split by strength.

Every file from this game

A whole NFL game you can replay change by change is on Sample responses.

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 nhl to another alias keeps your parser working.

Request or streamWhat it returns
GET /v1/nhl/games?date=2026-11-07A day's games with status, start time and score. Pass from and to instead for a range of up to 31 days.
GET /v1/nhl/games/{id}One game with its teams, venue and live state
GET /v1/nhl/games/{id}/playsEvery play or match event, in game order
GET /v1/nhl/games/{id}/boxscoreA stat line for each player
GET /v1/nhl/games/{id}/rosterThe players in the game, with team and jersey
GET /v1/nhl/games/{id}/changes?after_seq=0Every change after a seq: the same journal the stream sends
GET /v1/nhl/injuriesThe current injury report
GET /v1/nhl/teamsThe league's teams
game:<id>WebSocket stream for one game: the game, its live state, plays, stats and roster, in seq order
league:nhlWebSocket 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 NHL game has

The fields below are what the sample game's responses contain. Coverage by league has the list of what isn't filled yet for every league.

  • Strength on every play: even, power_play or shorthanded
  • Penalties with penalty_minutes and penalty_severity
  • Shot type and rink_x and rink_y, plus empty-net and shootout flags
  • Separate skaters and goalies box score categories
  • GET /v1/nhl/injuries, the league's current injury report
  • The field-by-field table on /docs/coverage doesn't describe hockey yet, so this page lists what the sample game's responses contain. The not-filled-yet list below applies to every league.
  • NHL games run in three periods. GET /v1/leagues says so with period_kind period, and the live state's hockey object carries the shootout score.

Box score stat codes in this game

CategoryCodes
skatershits, goals, shifts, assists, giveaways, penalties, takeaways, plus_minus, faceoff_pct, time_on_ice, faceoffs_won, missed_shots, blocked_shots, faceoffs_lost, shots_on_goal, shootout_goals, penalty_minutes, power_play_time_on_ice, short_handed_time_on_ice, even_strength_time_on_ice
goaliessaves, save_pct, time_on_ice, goals_against, shots_against, shootout_saves, penalty_minutes, power_play_saves, short_handed_saves, even_strength_saves, shootout_shots_against

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 NHL 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
Player detailsbirth_date, height_in, weight_lb, college and draft on playersnull

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