NHL games API
games
nhl.gamesEvery scheduled and played NHL game — preseason, the 82-game regular season, and the four-round Stanley Cup Playoffs through the Stanley Cup Final.
GET/api/v1/nhl/gamesList games for NHL
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a season. Defaults to the current season.
home_team_idquerybigintoptionalFilter by home team.
away_team_idquerybigintoptionalFilter by away team.
statusquerystringoptionalFilter by game status.
dayqueryintegeroptionalFilter by calendar day (YYYY-MM-DD date) — e.g. day=2026-06-09 for today's slate. season_id defaults to the current season; pass it explicitly for past-season days. Range syntax: day__gte=, day__lte=, day__between=.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/nhl/games?season_id=2026'Responses
200games rows matching the declared filter set, wrapped in { games, limit, next_from_id, has_more }. has_more is true when another row follows this page. To walk every row, start with ?from_id=0 and pass each next_from_id back as from_id until it is null; the filters stay. A first page without from_id comes in the default order and gives next_from_id null.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.
application/jsonResponse Schema(35 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
arena_id | bigintnullable | — e.g. 1 | |
away_team_id | bigint | — e.g. 1 | |
home_team_id | bigint | — e.g. 1 | |
league_game_id | integernullable | — | Official NHL game ID (issued by the league) e.g. 2024020051 |
league_id | stringnullable | — | Official NHL game identifier e.g. — (all-null in sample) |
season_id | bigint | — e.g. 2021 | |
attendance | integernullable | — | — e.g. — (all-null in sample) |
away_team_score | integernullable | — | — e.g. 2 |
away_team_score_overtime | integernullable | — | — e.g. 0 |
away_team_score_period1 | integernullable | — | — e.g. 0 |
away_team_score_period2 | integernullable | — | — e.g. 1 |
away_team_score_period3 | integernullable | — | — e.g. 1 |
away_team_series_wins | integernullable | — | — e.g. — (all-null in sample) |
channel | stringnullable | — | — e.g. — (all-null in sample) |
day | integer | — | Calendar day as a YYYYMMDD integer (e.g. 20240915), US Eastern. e.g. 20241022 |
game_time | timestamptz | — | Scheduled puck drop (timezone-aware). e.g. 2025-11-27T00:00:00.000Z |
home_team_score | integernullable | — | — e.g. 3 |
home_team_score_overtime | integernullable | — | — e.g. 0 |
home_team_score_period1 | integernullable | — | — e.g. 0 |
home_team_score_period2 | integernullable | — | — e.g. 1 |
home_team_score_period3 | integernullable | — | — e.g. 1 |
home_team_series_wins | integernullable | — | — e.g. — (all-null in sample) |
is_overtime | boolean | — | — Values:falsetrue |
is_shootout | boolean | — | — Values:falsetrue |
last_play | stringnullable | — | — e.g. — (all-null in sample) |
neutral_site | boolean | — | — Values:falsetrue |
overtime_periods | integernullable | — | — e.g. 0 |
period | stringnullable | — | Current period (1, 2, 3, OT, SO, Final) e.g. — (all-null in sample) |
playoff_round | stringnullable | — | First Round, Second Round, Conference Finals, Stanley Cup Final e.g. — (all-null in sample) |
season_type | string | — | Canonical season phase (text). Was integer 1/2/3/4 before the 2026-06-29 normalization. Values:regular_seasonpostseasonpreseason |
series_game_number | integernullable | — | — e.g. — (all-null in sample) |
status | string | — | — e.g. Final |
time_remaining_minutes | integernullable | — | — e.g. — (all-null in sample) |
time_remaining_seconds | integernullable | — | — e.g. — (all-null in sample) |
GET/api/v1/nhl/games/{id}Get a single game by id
Parameters
idpathbigintrequiredPrimary key (id) of the game 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/nhl/games/{pk_value}'Responses
200Single game row.application/jsonshow example ▸
404Row not found.
Response Schema(35 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
arena_id | bigintnullable | — e.g. 1 | |
away_team_id | bigint | — e.g. 1 | |
home_team_id | bigint | — e.g. 1 | |
league_game_id | integernullable | — | Official NHL game ID (issued by the league) e.g. 2024020051 |
league_id | stringnullable | — | Official NHL game identifier e.g. — (all-null in sample) |
season_id | bigint | — e.g. 2021 | |
attendance | integernullable | — | — e.g. — (all-null in sample) |
away_team_score | integernullable | — | — e.g. 2 |
away_team_score_overtime | integernullable | — | — e.g. 0 |
away_team_score_period1 | integernullable | — | — e.g. 0 |
away_team_score_period2 | integernullable | — | — e.g. 1 |
away_team_score_period3 | integernullable | — | — e.g. 1 |
away_team_series_wins | integernullable | — | — e.g. — (all-null in sample) |
channel | stringnullable | — | — e.g. — (all-null in sample) |
day | integer | — | Calendar day as a YYYYMMDD integer (e.g. 20240915), US Eastern. e.g. 20241022 |
game_time | timestamptz | — | Scheduled puck drop (timezone-aware). e.g. 2025-11-27T00:00:00.000Z |
home_team_score | integernullable | — | — e.g. 3 |
home_team_score_overtime | integernullable | — | — e.g. 0 |
home_team_score_period1 | integernullable | — | — e.g. 0 |
home_team_score_period2 | integernullable | — | — e.g. 1 |
home_team_score_period3 | integernullable | — | — e.g. 1 |
home_team_series_wins | integernullable | — | — e.g. — (all-null in sample) |
is_overtime | boolean | — | — Values:falsetrue |
is_shootout | boolean | — | — Values:falsetrue |
last_play | stringnullable | — | — e.g. — (all-null in sample) |
neutral_site | boolean | — | — Values:falsetrue |
overtime_periods | integernullable | — | — e.g. 0 |
period | stringnullable | — | Current period (1, 2, 3, OT, SO, Final) e.g. — (all-null in sample) |
playoff_round | stringnullable | — | First Round, Second Round, Conference Finals, Stanley Cup Final e.g. — (all-null in sample) |
season_type | string | — | Canonical season phase (text). Was integer 1/2/3/4 before the 2026-06-29 normalization. Values:regular_seasonpostseasonpreseason |
series_game_number | integernullable | — | — e.g. — (all-null in sample) |
status | string | — | — e.g. Final |
time_remaining_minutes | integernullable | — | — e.g. — (all-null in sample) |
time_remaining_seconds | integernullable | — | — e.g. — (all-null in sample) |