NHL API Reference
Every NHL game across the regular season and the four-round Stanley Cup Playoffs since 2021-22 — box scores, DraftKings and FanDuel fantasy points, starting goalies, forward lines and defensive pairings, consensus game lines and player props, standings, schedule context, play-by-play, shifts, game-day rosters, officials, broadcasters, head coaches, scoring plays and penalties.
Main
seasons
nhl.seasonsEach NHL season — preseason exhibitions, the 82-game regular season, and the Stanley Cup Playoffs (Wild Card, Divisional, Conference Finals, Stanley Cup Finals).
GET/api/v1/nhl/seasonsList seasons for NHL
Parameters
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/seasons?limit=3'Responses
200seasons rows matching the declared filter set, wrapped in { seasons, 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(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_id | stringnullable | — | Official NHL season identifier e.g. — (all-null in sample) |
end_date | timestamptznullable | — | — e.g. 2020-09-19T04:00:00.000Z |
post_season_start_date | timestamptznullable | — | — e.g. 2020-08-01T04:00:00.000Z |
regular_season_start_date | timestamptznullable | — | — e.g. 2019-10-02T04:00:00.000Z |
stanley_cup_finals_date | timestamptznullable | — | — e.g. 2020-09-19T04:00:00.000Z |
start_date | timestamptz | — | — e.g. 2019-10-02T04:00:00.000Z |
start_year | integer | — | — e.g. 2019 |
GET/api/v1/nhl/seasons/{id}Get a single season by id
Parameters
idpathbigintrequiredPrimary 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/nhl/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 |
league_id | stringnullable | — | Official NHL season identifier e.g. — (all-null in sample) |
end_date | timestamptznullable | — | — e.g. 2020-09-19T04:00:00.000Z |
post_season_start_date | timestamptznullable | — | — e.g. 2020-08-01T04:00:00.000Z |
regular_season_start_date | timestamptznullable | — | — e.g. 2019-10-02T04:00:00.000Z |
stanley_cup_finals_date | timestamptznullable | — | — e.g. 2020-09-19T04:00:00.000Z |
start_date | timestamptz | — | — e.g. 2019-10-02T04:00:00.000Z |
start_year | integer | — | — e.g. 2019 |
teams
nhl.teamsThe 32 NHL franchises, organized into the Eastern and Western Conferences with two divisions each (Atlantic, Metropolitan, Central, Pacific).
GET/api/v1/nhl/teamsList teams for NHL
Parameters
activequerybooleanoptionalFilter by active status (defaults to true to show only currently-active rows; pass active=false to include inactive).
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/teams?limit=3'Responses
200teams rows matching the declared filter set, wrapped in { teams, 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(18 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
arena_id | bigintnullable | — e.g. 1 | |
league_team_id | integernullable | — | Official NHL team ID (issued by the league) e.g. 6 |
abbreviation | string | — | — e.g. BOS |
active | boolean | — | — e.g. true |
city | string | — | — e.g. Boston |
conference | string | — | — Values:EasternWestern |
division | string | — | — Values:AtlanticMetropolitanCentralPacific |
full_name | string | — | — e.g. Boston Boston Bruins |
head_coach | stringnullable | — | — e.g. — (all-null in sample) |
logo_url | stringnullable | — | URL to team logo image e.g. — (all-null in sample) |
name | string | — | — e.g. Boston Bruins |
primary_color | stringnullable | — | — e.g. — (all-null in sample) |
quaternary_color | stringnullable | — | — e.g. — (all-null in sample) |
secondary_color | stringnullable | — | — e.g. — (all-null in sample) |
tertiary_color | stringnullable | — | — e.g. — (all-null in sample) |
wikipedia_logo_url | stringnullable | — | — e.g. — (all-null in sample) |
wikipedia_wordmark_url | stringnullable | — | — e.g. — (all-null in sample) |
GET/api/v1/nhl/teams/{id}Get a single team by id
Parameters
idpathbigintrequiredPrimary key (id) of the team 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/teams/{pk_value}'Responses
200Single team row.application/jsonshow example ▸
404Row not found.
Response Schema(18 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
arena_id | bigintnullable | — e.g. 1 | |
league_team_id | integernullable | — | Official NHL team ID (issued by the league) e.g. 6 |
abbreviation | string | — | — e.g. BOS |
active | boolean | — | — e.g. true |
city | string | — | — e.g. Boston |
conference | string | — | — Values:EasternWestern |
division | string | — | — Values:AtlanticMetropolitanCentralPacific |
full_name | string | — | — e.g. Boston Boston Bruins |
head_coach | stringnullable | — | — e.g. — (all-null in sample) |
logo_url | stringnullable | — | URL to team logo image e.g. — (all-null in sample) |
name | string | — | — e.g. Boston Bruins |
primary_color | stringnullable | — | — e.g. — (all-null in sample) |
quaternary_color | stringnullable | — | — e.g. — (all-null in sample) |
secondary_color | stringnullable | — | — e.g. — (all-null in sample) |
tertiary_color | stringnullable | — | — e.g. — (all-null in sample) |
wikipedia_logo_url | stringnullable | — | — e.g. — (all-null in sample) |
wikipedia_wordmark_url | stringnullable | — | — e.g. — (all-null in sample) |
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) |
players
nhl.playersEvery individual who has played in the NHL — current rosters, AHL call-ups, free agents, and retired players, with their shooting hand, position, and home country.
GET/api/v1/nhl/playersList players for NHL
Requires one of:
team_id or roster_status — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter to players whose current team_id matches. Null team_id rows (free agents, retired) are excluded when this filter is applied.
roster_statusquerystringoptionalFilter by canonical roster status. NHL source granularity is coarse: "active" (on a current team roster), "free_agent" (no team), "inactive" (not currently rostered); injured_reserve appears where derivable. The "on a team now" set is {active, injured_reserve}. Values: active, injured_reserve, inactive, free_agent.
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/players?team_id=1'Responses
200players rows matching the declared filter set, wrapped in { players, 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 |
draft_team_id | bigintnullable | — e.g. — (all-null in sample) | |
league_id | stringnullable | — | Official NHL player identifier e.g. — (all-null in sample) |
league_player_id | integer | — | Official NHL player ID (issued by the league) e.g. 8482705 |
team_id | bigintnullable | — e.g. 27 | |
birth_city | stringnullable | — | — e.g. Toronto |
birth_country | stringnullable | — | — e.g. CAN |
birth_date | datenullable | — | — e.g. 2004-03-30 |
birth_state | stringnullable | — | — e.g. Ontario |
catches | stringnullable | — | — Values:LR |
college | stringnullable | — | — e.g. — (all-null in sample) |
draft_overall_pick | integernullable | — | — e.g. 2 |
draft_pick | integernullable | — | — e.g. 1 |
draft_round | integernullable | — | — e.g. 1 |
draft_year | integernullable | — | — e.g. 2022 |
experience | integernullable | — | Years of NHL experience e.g. — (all-null in sample) |
first_name | string | — | — e.g. Ryan |
full_name | string | — | — e.g. Elias Pettersson |
height | integernullable | — | Height in inches e.g. 74 |
injury_body_part | stringnullable | — | — e.g. — (all-null in sample) |
injury_notes | stringnullable | — | — e.g. — (all-null in sample) |
injury_start_date | timestamptznullable | — | — e.g. — (all-null in sample) |
injury_status | stringnullable | — | — e.g. — (all-null in sample) |
jersey | stringnullable | — | — e.g. 44 |
last_name | string | — | — e.g. Smith |
nationality | stringnullable | — | — e.g. — (all-null in sample) |
photo_url | stringnullable | — | URL to player headshot image e.g. https://assets.nhle.com/mugs/nhl/20262027/CBJ/8482705.png |
position_category | stringnullable | — | — e.g. — (all-null in sample) |
primary_position | string | — | — Values:DCGLLWRWR |
rookie_year | integernullable | — | — e.g. — (all-null in sample) |
roster_status | stringnullable | — | Canonical roster status, shared across leagues. NHL source granularity is coarse: "active" (on a current api-web team roster), "free_agent" (no team), "inactive" (not currently rostered); injured_reserve where derivable. The "on a team now" set is {active, injured_reserve}. Values:inactiveactive |
shoots | stringnullable | — | — Values:LR |
weight | integernullable | — | Weight in pounds e.g. 190 |
youth_league | stringnullable | — | — e.g. — (all-null in sample) |
youth_team | stringnullable | — | — e.g. — (all-null in sample) |
GET/api/v1/nhl/players/{id}Get a single player by id
Parameters
idpathbigintrequiredPrimary key (id) of the player 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/players/{pk_value}'Responses
200Single player row.application/jsonshow example ▸
404Row not found.
Response Schema(35 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
draft_team_id | bigintnullable | — e.g. — (all-null in sample) | |
league_id | stringnullable | — | Official NHL player identifier e.g. — (all-null in sample) |
league_player_id | integer | — | Official NHL player ID (issued by the league) e.g. 8482705 |
team_id | bigintnullable | — e.g. 27 | |
birth_city | stringnullable | — | — e.g. Toronto |
birth_country | stringnullable | — | — e.g. CAN |
birth_date | datenullable | — | — e.g. 2004-03-30 |
birth_state | stringnullable | — | — e.g. Ontario |
catches | stringnullable | — | — Values:LR |
college | stringnullable | — | — e.g. — (all-null in sample) |
draft_overall_pick | integernullable | — | — e.g. 2 |
draft_pick | integernullable | — | — e.g. 1 |
draft_round | integernullable | — | — e.g. 1 |
draft_year | integernullable | — | — e.g. 2022 |
experience | integernullable | — | Years of NHL experience e.g. — (all-null in sample) |
first_name | string | — | — e.g. Ryan |
full_name | string | — | — e.g. Elias Pettersson |
height | integernullable | — | Height in inches e.g. 74 |
injury_body_part | stringnullable | — | — e.g. — (all-null in sample) |
injury_notes | stringnullable | — | — e.g. — (all-null in sample) |
injury_start_date | timestamptznullable | — | — e.g. — (all-null in sample) |
injury_status | stringnullable | — | — e.g. — (all-null in sample) |
jersey | stringnullable | — | — e.g. 44 |
last_name | string | — | — e.g. Smith |
nationality | stringnullable | — | — e.g. — (all-null in sample) |
photo_url | stringnullable | — | URL to player headshot image e.g. https://assets.nhle.com/mugs/nhl/20262027/CBJ/8482705.png |
position_category | stringnullable | — | — e.g. — (all-null in sample) |
primary_position | string | — | — Values:DCGLLWRWR |
rookie_year | integernullable | — | — e.g. — (all-null in sample) |
roster_status | stringnullable | — | Canonical roster status, shared across leagues. NHL source granularity is coarse: "active" (on a current api-web team roster), "free_agent" (no team), "inactive" (not currently rostered); injured_reserve where derivable. The "on a team now" set is {active, injured_reserve}. Values:inactiveactive |
shoots | stringnullable | — | — Values:LR |
weight | integernullable | — | Weight in pounds e.g. 190 |
youth_league | stringnullable | — | — e.g. — (all-null in sample) |
youth_team | stringnullable | — | — e.g. — (all-null in sample) |
Plays
game_shifts
nhl.game_shiftsEvery shift of every player in every NHL game since 2021-22 — the period, when the player came on and went off the ice and how long the shift lasted.
GET/api/v1/nhl/game_shiftsList game_shifts for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
player_idquerybigintoptionalFilter to a single player.
periodqueryintegeroptionalFilter to a period (1-3; 4 and up for overtime).
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/game_shifts?game_id=1'Responses
200game_shifts rows matching the declared filter set, wrapped in { game_shifts, 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(11 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 15957 | |
league_shift_id | bigintnullable | — | The league's id for this shift. Empty for a shift rebuilt from the official time-on-ice report. e.g. — (all-null in sample) |
player_id | bigint | — e.g. 6878 | |
team_id | bigint | — e.g. 30 | |
detail_code | integernullable | — | The league's shift detail code (0 for a regular shift). Empty for a shift rebuilt from the official time-on-ice report. e.g. — (all-null in sample) |
duration_seconds | integer | — | — e.g. 43 |
end_seconds | integer | — | Seconds elapsed in the period when the shift ended e.g. 1200 |
period | integer | — | — e.g. 1 |
shift_number | integer | — | The player's shift number in the game e.g. 1 |
start_seconds | integer | — | Seconds elapsed in the period when the shift started e.g. 0 |
GET/api/v1/nhl/game_shifts/{id}Get a single game_shift by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_shift 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/game_shifts/{pk_value}'Responses
200Single game_shift row.application/jsonshow example ▸
404Row not found.
Response Schema(11 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 15957 | |
league_shift_id | bigintnullable | — | The league's id for this shift. Empty for a shift rebuilt from the official time-on-ice report. e.g. — (all-null in sample) |
player_id | bigint | — e.g. 6878 | |
team_id | bigint | — e.g. 30 | |
detail_code | integernullable | — | The league's shift detail code (0 for a regular shift). Empty for a shift rebuilt from the official time-on-ice report. e.g. — (all-null in sample) |
duration_seconds | integer | — | — e.g. 43 |
end_seconds | integer | — | Seconds elapsed in the period when the shift ended e.g. 1200 |
period | integer | — | — e.g. 1 |
shift_number | integer | — | The player's shift number in the game e.g. 1 |
start_seconds | integer | — | Seconds elapsed in the period when the shift started e.g. 0 |
penalties
nhl.penaltiesEvery penalty assessed in every NHL game — the player penalized, the infraction (hooking, tripping, slashing, etc.), the minutes assessed (2-minute minor, 4-minute double minor, 5-minute major, game misconduct, match penalty), and the resulting power play.
GET/api/v1/nhl/penaltiesList penalties for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by penalized team.
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/penalties?game_id=1'Responses
200penalties rows matching the declared filter set, wrapped in { penalties, 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(12 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
drawn_by_player_id | bigintnullable | — e.g. 453 | |
game_id | bigint | — e.g. 4002 | |
penalty_id | integer | — | — e.g. 36 |
player_id | bigintnullable | — e.g. 1189 | |
team_id | bigint | — e.g. 16 | |
description | stringnullable | — | — e.g. — (all-null in sample) |
is_bench_penalty | boolean | — | — Values:falsetrue |
penalty_minutes | integer | — | — e.g. 2 |
penalty_type | string | — | — e.g. tripping |
period_number | integer | — | — e.g. 2 |
time_remaining | string | — | Time remaining in period (MM:SS) e.g. 00:00 |
GET/api/v1/nhl/penalties/{id}Get a single penalty by id
Parameters
idpathbigintrequiredPrimary key (id) of the penalty 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/penalties/{pk_value}'Responses
200Single penalty row.application/jsonshow example ▸
404Row not found.
Response Schema(12 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
drawn_by_player_id | bigintnullable | — e.g. 453 | |
game_id | bigint | — e.g. 4002 | |
penalty_id | integer | — | — e.g. 36 |
player_id | bigintnullable | — e.g. 1189 | |
team_id | bigint | — e.g. 16 | |
description | stringnullable | — | — e.g. — (all-null in sample) |
is_bench_penalty | boolean | — | — Values:falsetrue |
penalty_minutes | integer | — | — e.g. 2 |
penalty_type | string | — | — e.g. tripping |
period_number | integer | — | — e.g. 2 |
time_remaining | string | — | Time remaining in period (MM:SS) e.g. 00:00 |
periods
nhl.periodsPer-period scores for every NHL game — the three regulation periods plus any overtime and the shootout, with the away and home goals in each. (Shots and penalties per period are not carried here.)
GET/api/v1/nhl/periodsList periods for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
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/periods?game_id=1'Responses
200periods rows matching the declared filter set, wrapped in { periods, 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(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 5762 | |
league_game_id | integer | — | Official NHL game ID (issued by the league; matches nhl.games.league_game_id). e.g. 2020030184 |
period_id | integer | — | — e.g. 1 |
away_team_score | integer | — | — e.g. 0 |
home_team_score | integer | — | — e.g. 0 |
name | string | — | 1, 2, 3, OT, OT2, SO Values:1st2nd3rdOvertimeShootoutOT2OT3 |
period_number | integer | — | — e.g. 1 |
GET/api/v1/nhl/periods/{id}Get a single period by id
Parameters
idpathbigintrequiredPrimary key (id) of the period 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/periods/{pk_value}'Responses
200Single period row.application/jsonshow example ▸
404Row not found.
Response Schema(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 5762 | |
league_game_id | integer | — | Official NHL game ID (issued by the league; matches nhl.games.league_game_id). e.g. 2020030184 |
period_id | integer | — | — e.g. 1 |
away_team_score | integer | — | — e.g. 0 |
home_team_score | integer | — | — e.g. 0 |
name | string | — | 1, 2, 3, OT, OT2, SO Values:1st2nd3rdOvertimeShootoutOT2OT3 |
period_number | integer | — | — e.g. 1 |
play_by_plays
nhl.play_by_playsEvery event in every NHL game since 2021-22 — faceoffs, shots on goal, missed and blocked shots, hits, giveaways, takeaways, goals, penalties and stoppages — with the period, the game clock, the rink coordinates, the players involved and the score and shots on goal after the event.
GET/api/v1/nhl/play_by_playsList play_by_plays for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
period_numberqueryintegeroptionalFilter to a period (1-3; 4 and up for overtime or the shootout).
type_desc_keyquerystringoptionalFilter by event type. Values: blocked-shot, delayed-penalty, failed-shot-attempt, faceoff, game-end, giveaway, goal, hit, missed-shot, penalty, period-end, period-start, shootout-complete, shot-on-goal, stoppage, takeaway.
event_owner_team_idquerybigintoptionalFilter to the events of one team.
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/play_by_plays?game_id=1'Responses
200play_by_plays rows matching the declared filter set, wrapped in { play_by_plays, 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(39 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
assist1_player_id | bigintnullable | — e.g. 307 | |
assist2_player_id | bigintnullable | — e.g. 7123 | |
blocking_player_id | bigintnullable | — e.g. 15 | |
committed_by_player_id | bigintnullable | Player who took the penalty e.g. 834 | |
drawn_by_player_id | bigintnullable | Player who drew the penalty e.g. 308 | |
event_id | integer | — | The league's event number, unique within the game e.g. 58 |
event_owner_team_id | bigintnullable | Team credited with the event e.g. 29 | |
game_id | bigint | — e.g. 15003 | |
goalie_in_net_id | bigintnullable | Goaltender the shot was taken against e.g. 531 | |
hittee_player_id | bigintnullable | — e.g. 353 | |
hitting_player_id | bigintnullable | — e.g. 7297 | |
losing_player_id | bigintnullable | Faceoff loser e.g. 6627 | |
player_id | bigintnullable | Player of a giveaway or takeaway e.g. 105 | |
scoring_player_id | bigintnullable | — e.g. 858 | |
served_by_player_id | bigintnullable | Player who served the penalty (bench and goalie penalties) e.g. 7393 | |
shooting_player_id | bigintnullable | — e.g. 6757 | |
winning_player_id | bigintnullable | Faceoff winner e.g. 6627 | |
away_score | integernullable | — | Away goals after the event; empty on most event types e.g. 1 |
away_sog | integernullable | — | Away shots on goal after the event; empty on most event types e.g. 2 |
home_score | integernullable | — | Home goals after the event; empty on most event types e.g. 1 |
home_sog | integernullable | — | Home shots on goal after the event; empty on most event types e.g. 19 |
penalty_desc_key | stringnullable | — | The infraction (e.g. tripping, hooking, slashing) e.g. hooking |
penalty_minutes | integernullable | — | — e.g. 2 |
penalty_type_code | stringnullable | — | Penalty class (MIN minor, MAJ major, BEN bench minor, MIS misconduct, GAM game misconduct, MAT match, PS penalty shot) Values:MINMAJMISBENGAM |
period_number | integer | — | — e.g. 1 |
period_type | string | — | REG, OT or SO (shootout) Values:REGOTSO |
reason | stringnullable | — | Why a shot missed or play stopped (e.g. wide-of-net, icing, goalie-stopped-after-sog) e.g. wide-of-net |
secondary_reason | stringnullable | — | — Values:tv-timeouthome-timeoutvisitor-timeoutplayer-injuryice-problem |
shot_type | stringnullable | — | wrist, snap, slap, tip-in, backhand, deflected, wrap-around, bat, poke Values:wristslapsnapbackhandtip-indeflectedwrap-around |
situation_code | stringnullable | — | Four digits: away goalie in net (1/0), away skaters, home skaters, home goalie in net (1/0); e.g. 1551 is five on five e.g. 1551 |
sort_order | integernullable | — | Order of the event within the game e.g. 8 |
time_in_period_seconds | integer | — | Seconds elapsed in the period when the event happened e.g. 0 |
time_remaining_seconds | integer | — | Seconds left in the period when the event happened e.g. 1200 |
type_code | integer | — | The league's numeric event type (e.g. 505 goal, 506 shot on goal, 502 faceoff) e.g. 502 |
type_desc_key | string | — | Event type (e.g. goal, shot-on-goal, faceoff, hit, penalty) Values:faceoffshot-on-goalhitstoppageblocked-shotmissed-shotgiveawaytakeawaypenaltygoalperiod-startperiod-enddelayed-penaltygame-endshootout-complete |
x_coord | integernullable | — | Rink x coordinate in feet from center ice e.g. 69 |
y_coord | integernullable | — | Rink y coordinate in feet from center ice e.g. 22 |
zone_code | stringnullable | — | Zone of the event for the owning team (O offensive, D defensive, N neutral) Values:ODN |
GET/api/v1/nhl/play_by_plays/{id}Get a single play_by_play by id
Parameters
idpathbigintrequiredPrimary key (id) of the play_by_play 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/play_by_plays/{pk_value}'Responses
200Single play_by_play row.application/jsonshow example ▸
404Row not found.
Response Schema(39 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
assist1_player_id | bigintnullable | — e.g. 307 | |
assist2_player_id | bigintnullable | — e.g. 7123 | |
blocking_player_id | bigintnullable | — e.g. 15 | |
committed_by_player_id | bigintnullable | Player who took the penalty e.g. 834 | |
drawn_by_player_id | bigintnullable | Player who drew the penalty e.g. 308 | |
event_id | integer | — | The league's event number, unique within the game e.g. 58 |
event_owner_team_id | bigintnullable | Team credited with the event e.g. 29 | |
game_id | bigint | — e.g. 15003 | |
goalie_in_net_id | bigintnullable | Goaltender the shot was taken against e.g. 531 | |
hittee_player_id | bigintnullable | — e.g. 353 | |
hitting_player_id | bigintnullable | — e.g. 7297 | |
losing_player_id | bigintnullable | Faceoff loser e.g. 6627 | |
player_id | bigintnullable | Player of a giveaway or takeaway e.g. 105 | |
scoring_player_id | bigintnullable | — e.g. 858 | |
served_by_player_id | bigintnullable | Player who served the penalty (bench and goalie penalties) e.g. 7393 | |
shooting_player_id | bigintnullable | — e.g. 6757 | |
winning_player_id | bigintnullable | Faceoff winner e.g. 6627 | |
away_score | integernullable | — | Away goals after the event; empty on most event types e.g. 1 |
away_sog | integernullable | — | Away shots on goal after the event; empty on most event types e.g. 2 |
home_score | integernullable | — | Home goals after the event; empty on most event types e.g. 1 |
home_sog | integernullable | — | Home shots on goal after the event; empty on most event types e.g. 19 |
penalty_desc_key | stringnullable | — | The infraction (e.g. tripping, hooking, slashing) e.g. hooking |
penalty_minutes | integernullable | — | — e.g. 2 |
penalty_type_code | stringnullable | — | Penalty class (MIN minor, MAJ major, BEN bench minor, MIS misconduct, GAM game misconduct, MAT match, PS penalty shot) Values:MINMAJMISBENGAM |
period_number | integer | — | — e.g. 1 |
period_type | string | — | REG, OT or SO (shootout) Values:REGOTSO |
reason | stringnullable | — | Why a shot missed or play stopped (e.g. wide-of-net, icing, goalie-stopped-after-sog) e.g. wide-of-net |
secondary_reason | stringnullable | — | — Values:tv-timeouthome-timeoutvisitor-timeoutplayer-injuryice-problem |
shot_type | stringnullable | — | wrist, snap, slap, tip-in, backhand, deflected, wrap-around, bat, poke Values:wristslapsnapbackhandtip-indeflectedwrap-around |
situation_code | stringnullable | — | Four digits: away goalie in net (1/0), away skaters, home skaters, home goalie in net (1/0); e.g. 1551 is five on five e.g. 1551 |
sort_order | integernullable | — | Order of the event within the game e.g. 8 |
time_in_period_seconds | integer | — | Seconds elapsed in the period when the event happened e.g. 0 |
time_remaining_seconds | integer | — | Seconds left in the period when the event happened e.g. 1200 |
type_code | integer | — | The league's numeric event type (e.g. 505 goal, 506 shot on goal, 502 faceoff) e.g. 502 |
type_desc_key | string | — | Event type (e.g. goal, shot-on-goal, faceoff, hit, penalty) Values:faceoffshot-on-goalhitstoppageblocked-shotmissed-shotgiveawaytakeawaypenaltygoalperiod-startperiod-enddelayed-penaltygame-endshootout-complete |
x_coord | integernullable | — | Rink x coordinate in feet from center ice e.g. 69 |
y_coord | integernullable | — | Rink y coordinate in feet from center ice e.g. 22 |
zone_code | stringnullable | — | Zone of the event for the owning team (O offensive, D defensive, N neutral) Values:ODN |
scoring_plays
nhl.scoring_playsEvery goal scored in every NHL game — the scorer, the assists, the goaltender beaten, the strength (even strength, power play, short-handed), and the score state when the goal went in.
GET/api/v1/nhl/scoring_playsList scoring_plays for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by scoring team.
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/scoring_plays?game_id=1'Responses
200scoring_plays rows matching the declared filter set, wrapped in { scoring_plays, 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(13 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 4367 | |
primary_assist_player_id | bigintnullable | — e.g. 1120 | |
scored_by_player_id | bigintnullable | — e.g. 161 | |
scoring_play_id | integer | — | — e.g. 99 |
secondary_assist_player_id | bigintnullable | — e.g. 126 | |
team_id | bigint | — e.g. 7 | |
away_team_score | integer | — | — e.g. 1 |
description | stringnullable | — | — e.g. — (all-null in sample) |
goal_type | stringnullable | — | — Values:wristsnapslapbackhandtip-indeflectedwrap-aroundbatpoke |
home_team_score | integer | — | — e.g. 1 |
period_number | integer | — | — e.g. 3 |
time_remaining | string | — | Time remaining in period (MM:SS) e.g. 00:59 |
GET/api/v1/nhl/scoring_plays/{id}Get a single scoring_play by id
Parameters
idpathbigintrequiredPrimary key (id) of the scoring_play 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/scoring_plays/{pk_value}'Responses
200Single scoring_play row.application/jsonshow example ▸
404Row not found.
Response Schema(13 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 4367 | |
primary_assist_player_id | bigintnullable | — e.g. 1120 | |
scored_by_player_id | bigintnullable | — e.g. 161 | |
scoring_play_id | integer | — | — e.g. 99 |
secondary_assist_player_id | bigintnullable | — e.g. 126 | |
team_id | bigint | — e.g. 7 | |
away_team_score | integer | — | — e.g. 1 |
description | stringnullable | — | — e.g. — (all-null in sample) |
goal_type | stringnullable | — | — Values:wristsnapslapbackhandtip-indeflectedwrap-aroundbatpoke |
home_team_score | integer | — | — e.g. 1 |
period_number | integer | — | — e.g. 3 |
time_remaining | string | — | Time remaining in period (MM:SS) e.g. 00:59 |
Stats
operator_team_lookups
nhl.operator_team_lookupsHow each sportsbook and fantasy operator names every NHL team — the mapping from each operator's team code to the unified franchise record.
GET/api/v1/nhl/operator_team_lookupsList operator_team_lookups for NHL
Requires one of:
operator_id — requests satisfying none of these return 400.Parameters
operator_idquerybigintoptionalFilter by operator.
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/operator_team_lookups?operator_id=1'Responses
200operator_team_lookups rows matching the declared filter set, wrapped in { operator_team_lookups, 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(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 1 | |
operator_team_id | string | — | External team ID from operator e.g. 4007 |
team_id | bigint | Internal nhl.teams.id reference e.g. 25 | |
abbreviation | stringnullable | — | Team abbreviation for reconciliation e.g. ANA |
team_name | stringnullable | — | Team name for reconciliation e.g. Anaheim Ducks |
GET/api/v1/nhl/operator_team_lookups/{id}Get a single operator_team_lookup by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_team_lookup 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/operator_team_lookups/{pk_value}'Responses
200Single operator_team_lookup row.application/jsonshow example ▸
404Row not found.
Response Schema(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 1 | |
operator_team_id | string | — | External team ID from operator e.g. 4007 |
team_id | bigint | Internal nhl.teams.id reference e.g. 25 | |
abbreviation | stringnullable | — | Team abbreviation for reconciliation e.g. ANA |
team_name | stringnullable | — | Team name for reconciliation e.g. Anaheim Ducks |
season_team_stats
nhl.season_team_statsSeason totals for each NHL team — wins, losses, overtime losses, points, goals for and against, shooting percentage, save percentage, power-play and penalty-kill efficiency, faceoff percentages.
GET/api/v1/nhl/season_team_statsList season_team_stats for NHL
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
team_idquerybigintoptionalFilter by team.
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/season_team_stats?season_id=2026'Responses
200season_team_stats rows matching the declared filter set, wrapped in { season_team_stats, 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(36 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2025 | |
team_id | bigint | — e.g. 18 | |
blocked_shots | integer | — | — e.g. 0 |
faceoff_losses | integer | — | — e.g. 0 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoff_wins | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 82 |
giveaways | integer | — | — e.g. 0 |
goal_differential | integer | — | — e.g. 21 |
goals_against | integer | — | — e.g. 226 |
goals_against_average | decimal | — | — e.g. 0.0000 |
goals_against_per_game | decimal | — | — e.g. 3.0000 |
goals_for | integer | — | — e.g. 238 |
goals_per_game | decimal | — | — e.g. 3.0000 |
hits | integer | — | — e.g. 0 |
losses | integer | — | — e.g. 27 |
overtime_losses | integer | — | — e.g. 7 |
penalty_kill_goals_against | integer | — | — e.g. 0 |
penalty_kill_percentage | decimal | — | — e.g. 0.0000 |
penalty_minutes | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_opportunities | integer | — | — e.g. 0 |
power_play_percentage | decimal | — | — e.g. 0.0000 |
pts | integer | — | — e.g. 92 |
pts_percentage | decimal | — | — e.g. 0.5610 |
save_percentage | decimal | — | — e.g. 0.0000 |
season_type | string | — | Canonical season phase (text). Was integer 1/2/3 before the 2026-06-29 normalization. e.g. regular_season |
shooting_percentage | decimal | — | — e.g. 0.0000 |
short_handed_goals | integer | — | — e.g. 0 |
shots_against | integer | — | — e.g. 0 |
shots_for | integer | — | — e.g. 0 |
shutouts | integer | — | — e.g. 0 |
takeaways | integer | — | — e.g. 0 |
times_shorthanded | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 35 |
GET/api/v1/nhl/season_team_stats/{id}Get a single season_team_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the season_team_stat 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/season_team_stats/{pk_value}'Responses
200Single season_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(36 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2025 | |
team_id | bigint | — e.g. 18 | |
blocked_shots | integer | — | — e.g. 0 |
faceoff_losses | integer | — | — e.g. 0 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoff_wins | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 82 |
giveaways | integer | — | — e.g. 0 |
goal_differential | integer | — | — e.g. 21 |
goals_against | integer | — | — e.g. 226 |
goals_against_average | decimal | — | — e.g. 0.0000 |
goals_against_per_game | decimal | — | — e.g. 3.0000 |
goals_for | integer | — | — e.g. 238 |
goals_per_game | decimal | — | — e.g. 3.0000 |
hits | integer | — | — e.g. 0 |
losses | integer | — | — e.g. 27 |
overtime_losses | integer | — | — e.g. 7 |
penalty_kill_goals_against | integer | — | — e.g. 0 |
penalty_kill_percentage | decimal | — | — e.g. 0.0000 |
penalty_minutes | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_opportunities | integer | — | — e.g. 0 |
power_play_percentage | decimal | — | — e.g. 0.0000 |
pts | integer | — | — e.g. 92 |
pts_percentage | decimal | — | — e.g. 0.5610 |
save_percentage | decimal | — | — e.g. 0.0000 |
season_type | string | — | Canonical season phase (text). Was integer 1/2/3 before the 2026-06-29 normalization. e.g. regular_season |
shooting_percentage | decimal | — | — e.g. 0.0000 |
short_handed_goals | integer | — | — e.g. 0 |
shots_against | integer | — | — e.g. 0 |
shots_for | integer | — | — e.g. 0 |
shutouts | integer | — | — e.g. 0 |
takeaways | integer | — | — e.g. 0 |
times_shorthanded | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 35 |
standings
nhl.standingsCurrent conference and division standings for the NHL season — wins, losses, overtime losses, points, points percentage, games behind, and home/away splits. One snapshot per team per season (no as-of-date history).
GET/api/v1/nhl/standingsList standings for NHL
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
team_idquerybigintoptionalFilter by team.
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/standings?season_id=2026'Responses
200standings rows matching the declared filter set, wrapped in { standings, 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(36 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2025 | |
team_id | bigint | — e.g. 18 | |
away_losses | integer | — | — e.g. 19 |
away_overtime_losses | integer | — | — e.g. 4 |
away_wins | integer | — | — e.g. 17 |
clinched_conference | boolean | — | — e.g. false |
clinched_division | boolean | — | — e.g. false |
clinched_playoffs | boolean | — | — Values:truefalse |
clinched_presidents_trophy | boolean | — | — e.g. false |
conference | string | — | — Values:EasternWestern |
conference_rank | integer | — | — e.g. 0 |
division | string | — | — Values:MetropolitanAtlanticCentralPacificDiscover CentralMassMutual EastHonda WestScotia North |
division_rank | integer | — | — e.g. 1 |
games_played | integer | — | — e.g. 82 |
goal_differential | integer | — | — e.g. 21 |
goals_against | integer | — | — e.g. 226 |
goals_for | integer | — | — e.g. 238 |
home_losses | integer | — | — e.g. 13 |
home_overtime_losses | integer | — | — e.g. 4 |
home_wins | integer | — | — e.g. 20 |
last_10_losses | integer | — | — e.g. 4 |
last_10_overtime_losses | integer | — | — e.g. 1 |
last_10_wins | integer | — | — e.g. 6 |
losses | integer | — | — e.g. 27 |
overtime_losses | integer | — | — e.g. 7 |
pts | integer | — | — e.g. 92 |
pts_percentage | decimal | — | — e.g. 0.5610 |
rank | integer | — | — e.g. 1 |
regulation_wins | integer | — | — e.g. 30 |
season_type | string | — | — e.g. regular_season |
shootout_losses | integer | — | — e.g. 2 |
shootout_wins | integer | — | — e.g. 2 |
streak | stringnullable | — | Current streak (W3, L2, OTL1) Values:W1L1W2L2OT1W3L3W4W6OT2W5L4L5W8W7W9OT4L7 |
wild_card_rank | integernullable | — | — e.g. 0 |
wins | integer | — | — e.g. 35 |
GET/api/v1/nhl/standings/{id}Get a single standing by id
Parameters
idpathbigintrequiredPrimary key (id) of the standing 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/standings/{pk_value}'Responses
200Single standing row.application/jsonshow example ▸
404Row not found.
Response Schema(36 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2025 | |
team_id | bigint | — e.g. 18 | |
away_losses | integer | — | — e.g. 19 |
away_overtime_losses | integer | — | — e.g. 4 |
away_wins | integer | — | — e.g. 17 |
clinched_conference | boolean | — | — e.g. false |
clinched_division | boolean | — | — e.g. false |
clinched_playoffs | boolean | — | — Values:truefalse |
clinched_presidents_trophy | boolean | — | — e.g. false |
conference | string | — | — Values:EasternWestern |
conference_rank | integer | — | — e.g. 0 |
division | string | — | — Values:MetropolitanAtlanticCentralPacificDiscover CentralMassMutual EastHonda WestScotia North |
division_rank | integer | — | — e.g. 1 |
games_played | integer | — | — e.g. 82 |
goal_differential | integer | — | — e.g. 21 |
goals_against | integer | — | — e.g. 226 |
goals_for | integer | — | — e.g. 238 |
home_losses | integer | — | — e.g. 13 |
home_overtime_losses | integer | — | — e.g. 4 |
home_wins | integer | — | — e.g. 20 |
last_10_losses | integer | — | — e.g. 4 |
last_10_overtime_losses | integer | — | — e.g. 1 |
last_10_wins | integer | — | — e.g. 6 |
losses | integer | — | — e.g. 27 |
overtime_losses | integer | — | — e.g. 7 |
pts | integer | — | — e.g. 92 |
pts_percentage | decimal | — | — e.g. 0.5610 |
rank | integer | — | — e.g. 1 |
regulation_wins | integer | — | — e.g. 30 |
season_type | string | — | — e.g. regular_season |
shootout_losses | integer | — | — e.g. 2 |
shootout_wins | integer | — | — e.g. 2 |
streak | stringnullable | — | Current streak (W3, L2, OTL1) Values:W1L1W2L2OT1W3L3W4W6OT2W5L4L5W8W7W9OT4L7 |
wild_card_rank | integernullable | — | — e.g. 0 |
wins | integer | — | — e.g. 35 |
team_standings
nhl.team_standingsEach NHL team's record entering each of its game days — wins, losses, overtime losses, points, point percentage, goals for and against, home/away splits, last-10 record, streak and games left. Computed from the games, with no look-ahead.
GET/api/v1/nhl/team_standingsList team_standings for NHL
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
team_idquerybigintoptionalFilter by team.
dayqueryintegeroptionalStandings entering this day (YYYYMMDD integer). Range syntax: day__gte=, day__lte=, day__between=.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; 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/team_standings?season_id=2026'Responses
200team_standings rows matching the declared filter set, wrapped in { team_standings, 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(25 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2021 | |
team_id | bigint | — e.g. 4 | |
away_losses | integer | — | — e.g. 11 |
away_overtime_losses | integer | — | — e.g. 2 |
away_wins | integer | — | — e.g. 3 |
day | integer | — | YYYYMMDD — the record entering this day (games before it) e.g. 20220429 |
games_played | integer | — | — e.g. 82 |
games_remaining | integer | — | — e.g. 0 |
goals_against | integer | — | — e.g. 0 |
goals_for | integer | — | — e.g. 0 |
home_losses | integer | — | — e.g. 3 |
home_overtime_losses | integer | — | — e.g. 1 |
home_wins | integer | — | — e.g. 10 |
l10_losses | integer | — | — e.g. 3 |
l10_overtime_losses | integer | — | — e.g. 1 |
l10_wins | integer | — | — e.g. 6 |
losses | integer | — | — e.g. 21 |
overtime_losses | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
pts_percentage | decimalnullable | — | — e.g. 0.5000 |
regulation_wins | integer | — | — e.g. 7 |
season_type | string | — | regular_season or postseason (the record is the regular-season record) Values:regular_seasonpostseason |
streak | stringnullable | — | e.g. W3, L1, OT2 e.g. W1 |
wins | integer | — | — e.g. 10 |
GET/api/v1/nhl/team_standings/{id}Get a single team_standing by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_standing 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/team_standings/{pk_value}'Responses
200Single team_standing row.application/jsonshow example ▸
404Row not found.
Response Schema(25 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2021 | |
team_id | bigint | — e.g. 4 | |
away_losses | integer | — | — e.g. 11 |
away_overtime_losses | integer | — | — e.g. 2 |
away_wins | integer | — | — e.g. 3 |
day | integer | — | YYYYMMDD — the record entering this day (games before it) e.g. 20220429 |
games_played | integer | — | — e.g. 82 |
games_remaining | integer | — | — e.g. 0 |
goals_against | integer | — | — e.g. 0 |
goals_for | integer | — | — e.g. 0 |
home_losses | integer | — | — e.g. 3 |
home_overtime_losses | integer | — | — e.g. 1 |
home_wins | integer | — | — e.g. 10 |
l10_losses | integer | — | — e.g. 3 |
l10_overtime_losses | integer | — | — e.g. 1 |
l10_wins | integer | — | — e.g. 6 |
losses | integer | — | — e.g. 21 |
overtime_losses | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
pts_percentage | decimalnullable | — | — e.g. 0.5000 |
regulation_wins | integer | — | — e.g. 7 |
season_type | string | — | regular_season or postseason (the record is the regular-season record) Values:regular_seasonpostseason |
streak | stringnullable | — | e.g. W3, L1, OT2 e.g. W1 |
wins | integer | — | — e.g. 10 |
game_player_stats
nhl.game_player_statsEach NHL player's stat line for each game — goals, assists, plus-minus, shots on goal, hits, blocks, penalties in minutes, power-play points, time on ice, plus the goaltender line (saves, shots against, goals against, save percentage).
GET/api/v1/nhl/game_player_statsList game_player_stats for NHL
Requires one of:
game_id or player_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player.
team_idquerybigintoptionalFilter by team.
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/game_player_stats?game_id=1'Responses
200game_player_stats rows matching the declared filter set, wrapped in { game_player_stats, 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(67 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 1 | |
opponent_id | bigintnullable | — | — e.g. 27 |
player_id | bigint | — e.g. 51 | |
team_id | bigint | — e.g. 27 | |
assists | integer | — | — e.g. 0 |
blocked_shots | integer | — | — e.g. 0 |
empty_net_goals | integer | — | — e.g. 0 |
even_strength_assists | integer | — | — e.g. 0 |
even_strength_goals | integer | — | — e.g. 0 |
even_strength_time_on_ice_seconds | integer | — | — e.g. 0 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoffs_lost | integer | — | — e.g. 0 |
faceoffs_won | integer | — | — e.g. 0 |
first_period_goals_against | integer | — | — e.g. 0 |
game_winning_goals | integer | — | — e.g. 0 |
games | integer | — | 1 if player appeared, 0 if not e.g. 1 |
giveaways | integer | — | — e.g. 0 |
goals | integer | — | — e.g. 0 |
goals_against | integer | — | — e.g. 0 |
goals_against_average | decimal | — | — e.g. 0.0000 |
hits | integer | — | — e.g. 0 |
home_or_away | stringnullable | — | — e.g. — (all-null in sample) |
is_game_over | boolean | — | — e.g. true |
losses | integer | — | — e.g. 0 |
major_penalties | integer | — | — e.g. 0 |
minor_penalties | integer | — | — e.g. 0 |
minutes_played | integer | — | Goalie minutes played e.g. 0 |
overtime_goals | integer | — | — e.g. 0 |
overtime_goals_against | integer | — | — e.g. 0 |
overtime_losses | integer | — | — e.g. 0 |
penalties | integer | — | — e.g. 0 |
penalty_minutes | integer | — | — e.g. 0 |
plus_minus | integer | — | — e.g. 0 |
power_play_assists | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_goals_against | integer | — | — e.g. 0 |
power_play_pts | integer | — | — e.g. 0 |
power_play_saves | integer | — | — e.g. 0 |
power_play_shots_against | integer | — | — e.g. 0 |
power_play_time_on_ice_seconds | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
save_percentage | decimal | — | — e.g. 0.0000 |
saves | integer | — | — e.g. 0 |
second_period_goals_against | integer | — | — e.g. 0 |
shifts | integer | — | — e.g. 0 |
shooting_percentage | decimal | — | — e.g. 0.0000 |
shootout_attempts | integer | — | — e.g. 0 |
shootout_goals | integer | — | — e.g. 0 |
shootout_goals_against | integer | — | — e.g. 0 |
shootout_saves | integer | — | — e.g. 0 |
short_handed_assists | integer | — | — e.g. 0 |
short_handed_goals | integer | — | — e.g. 0 |
short_handed_goals_against | integer | — | — e.g. 0 |
short_handed_pts | integer | — | — e.g. 0 |
short_handed_saves | integer | — | — e.g. 0 |
short_handed_shots_against | integer | — | — e.g. 0 |
short_handed_time_on_ice_seconds | integer | — | — e.g. 0 |
shots | integer | — | — e.g. 0 |
shots_against | integer | — | — e.g. 0 |
shots_on_goal | integer | — | — e.g. 0 |
shutouts | integer | — | — e.g. 0 |
started | integer | — | — e.g. 0 |
takeaways | integer | — | — e.g. 0 |
third_period_goals_against | integer | — | — e.g. 0 |
time_on_ice_seconds | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 0 |
GET/api/v1/nhl/game_player_stats/{id}Get a single game_player_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_player_stat 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/game_player_stats/{pk_value}'Responses
200Single game_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(67 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 1 | |
opponent_id | bigintnullable | — | — e.g. 27 |
player_id | bigint | — e.g. 51 | |
team_id | bigint | — e.g. 27 | |
assists | integer | — | — e.g. 0 |
blocked_shots | integer | — | — e.g. 0 |
empty_net_goals | integer | — | — e.g. 0 |
even_strength_assists | integer | — | — e.g. 0 |
even_strength_goals | integer | — | — e.g. 0 |
even_strength_time_on_ice_seconds | integer | — | — e.g. 0 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoffs_lost | integer | — | — e.g. 0 |
faceoffs_won | integer | — | — e.g. 0 |
first_period_goals_against | integer | — | — e.g. 0 |
game_winning_goals | integer | — | — e.g. 0 |
games | integer | — | 1 if player appeared, 0 if not e.g. 1 |
giveaways | integer | — | — e.g. 0 |
goals | integer | — | — e.g. 0 |
goals_against | integer | — | — e.g. 0 |
goals_against_average | decimal | — | — e.g. 0.0000 |
hits | integer | — | — e.g. 0 |
home_or_away | stringnullable | — | — e.g. — (all-null in sample) |
is_game_over | boolean | — | — e.g. true |
losses | integer | — | — e.g. 0 |
major_penalties | integer | — | — e.g. 0 |
minor_penalties | integer | — | — e.g. 0 |
minutes_played | integer | — | Goalie minutes played e.g. 0 |
overtime_goals | integer | — | — e.g. 0 |
overtime_goals_against | integer | — | — e.g. 0 |
overtime_losses | integer | — | — e.g. 0 |
penalties | integer | — | — e.g. 0 |
penalty_minutes | integer | — | — e.g. 0 |
plus_minus | integer | — | — e.g. 0 |
power_play_assists | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_goals_against | integer | — | — e.g. 0 |
power_play_pts | integer | — | — e.g. 0 |
power_play_saves | integer | — | — e.g. 0 |
power_play_shots_against | integer | — | — e.g. 0 |
power_play_time_on_ice_seconds | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
save_percentage | decimal | — | — e.g. 0.0000 |
saves | integer | — | — e.g. 0 |
second_period_goals_against | integer | — | — e.g. 0 |
shifts | integer | — | — e.g. 0 |
shooting_percentage | decimal | — | — e.g. 0.0000 |
shootout_attempts | integer | — | — e.g. 0 |
shootout_goals | integer | — | — e.g. 0 |
shootout_goals_against | integer | — | — e.g. 0 |
shootout_saves | integer | — | — e.g. 0 |
short_handed_assists | integer | — | — e.g. 0 |
short_handed_goals | integer | — | — e.g. 0 |
short_handed_goals_against | integer | — | — e.g. 0 |
short_handed_pts | integer | — | — e.g. 0 |
short_handed_saves | integer | — | — e.g. 0 |
short_handed_shots_against | integer | — | — e.g. 0 |
short_handed_time_on_ice_seconds | integer | — | — e.g. 0 |
shots | integer | — | — e.g. 0 |
shots_against | integer | — | — e.g. 0 |
shots_on_goal | integer | — | — e.g. 0 |
shutouts | integer | — | — e.g. 0 |
started | integer | — | — e.g. 0 |
takeaways | integer | — | — e.g. 0 |
third_period_goals_against | integer | — | — e.g. 0 |
time_on_ice_seconds | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 0 |
game_team_stats
nhl.game_team_statsEach NHL team's stat line for each game — goals scored and allowed, shots on goal, power-play and penalty-kill performance, faceoff percentage, hits, blocks, and time-on-ice splits.
GET/api/v1/nhl/game_team_statsList game_team_stats for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
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/game_team_stats?game_id=1'Responses
200game_team_stats rows matching the declared filter set, wrapped in { game_team_stats, 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(30 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 1 | |
team_id | bigint | — e.g. 7 | |
assists | integer | — | — e.g. 4 |
blocked_shots | integer | — | — e.g. 12 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoffs_lost | integer | — | — e.g. 0 |
faceoffs_won | integer | — | — e.g. 0 |
giveaways | integer | — | — e.g. 9 |
goals | integer | — | — e.g. 3 |
goals_against | integer | — | — e.g. 3 |
hits | integer | — | — e.g. 19 |
losses | integer | — | — e.g. 0 |
overtime_losses | integer | — | — e.g. 0 |
penalties | integer | — | — e.g. 0 |
penalty_kill_goals_against | integer | — | — e.g. 0 |
penalty_kill_percentage | decimal | — | — e.g. 0.0000 |
penalty_minutes | integer | — | — e.g. 6 |
power_play_attempts | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_percentage | decimal | — | — e.g. 0.0000 |
save_percentage | decimal | — | — e.g. 0.0000 |
saves | integer | — | — e.g. 28 |
shooting_percentage | decimal | — | — e.g. 0.0000 |
short_handed_goals | integer | — | — e.g. 0 |
shots | integer | — | — e.g. 28 |
shots_on_goal | integer | — | — e.g. 28 |
takeaways | integer | — | — e.g. 6 |
times_shorthanded | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 0 |
GET/api/v1/nhl/game_team_stats/{id}Get a single game_team_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_team_stat 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/game_team_stats/{pk_value}'Responses
200Single game_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(30 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 1 | |
team_id | bigint | — e.g. 7 | |
assists | integer | — | — e.g. 4 |
blocked_shots | integer | — | — e.g. 12 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoffs_lost | integer | — | — e.g. 0 |
faceoffs_won | integer | — | — e.g. 0 |
giveaways | integer | — | — e.g. 9 |
goals | integer | — | — e.g. 3 |
goals_against | integer | — | — e.g. 3 |
hits | integer | — | — e.g. 19 |
losses | integer | — | — e.g. 0 |
overtime_losses | integer | — | — e.g. 0 |
penalties | integer | — | — e.g. 0 |
penalty_kill_goals_against | integer | — | — e.g. 0 |
penalty_kill_percentage | decimal | — | — e.g. 0.0000 |
penalty_minutes | integer | — | — e.g. 6 |
power_play_attempts | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_percentage | decimal | — | — e.g. 0.0000 |
save_percentage | decimal | — | — e.g. 0.0000 |
saves | integer | — | — e.g. 28 |
shooting_percentage | decimal | — | — e.g. 0.0000 |
short_handed_goals | integer | — | — e.g. 0 |
shots | integer | — | — e.g. 28 |
shots_on_goal | integer | — | — e.g. 28 |
takeaways | integer | — | — e.g. 6 |
times_shorthanded | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 0 |
operator_game_fantasy_stats
nhl.operator_game_fantasy_statsGame-level NHL fantasy scoring summaries per operator — total points produced and the breakdown of how that total was assembled from individual stat categories.
GET/api/v1/nhl/operator_game_fantasy_statsList operator_game_fantasy_stats for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
operator_idquerybigintoptionalFilter by operator.
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/operator_game_fantasy_stats?game_id=1'Responses
200operator_game_fantasy_stats rows matching the declared filter set, wrapped in { operator_game_fantasy_stats, 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(65 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
operator_id | bigint | — e.g. 1 | |
operator_scoring_format_id | bigint | — | — e.g. 2 |
away_assist_fpts | decimal | — | — e.g. 40.0000 |
away_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
away_blocked_shot_fpts | decimal | — | — e.g. 20.8000 |
away_fpts | decimal | — | — e.g. 125.6000 |
away_goal_fpts | decimal | — | — e.g. 25.5000 |
away_goalie_win_fpts | decimal | — | — e.g. 0.0000 |
away_goals_against_fpts | decimal | — | — e.g. -10.5000 |
away_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
away_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
away_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
away_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
away_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
away_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
away_save_fpts | decimal | — | — e.g. 22.4000 |
away_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
away_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
away_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
away_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
away_shot_on_goal_fpts | decimal | — | — e.g. 48.0000 |
away_shutout_fpts | decimal | — | — e.g. 0.0000 |
home_assist_fpts | decimal | — | — e.g. 40.0000 |
home_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
home_blocked_shot_fpts | decimal | — | — e.g. 20.8000 |
home_fpts | decimal | — | — e.g. 133.6000 |
home_goal_fpts | decimal | — | — e.g. 25.5000 |
home_goalie_win_fpts | decimal | — | — e.g. 0.0000 |
home_goals_against_fpts | decimal | — | — e.g. -10.5000 |
home_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
home_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
home_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
home_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
home_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
home_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
home_save_fpts | decimal | — | — e.g. 22.4000 |
home_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
home_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
home_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
home_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
home_shot_on_goal_fpts | decimal | — | — e.g. 48.0000 |
home_shutout_fpts | decimal | — | — e.g. 0.0000 |
player_count | integer | — | — e.g. 40 |
total_assist_fpts | decimal | — | — e.g. 40.0000 |
total_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_blocked_shot_fpts | decimal | — | — e.g. 41.6000 |
total_fpts | decimal | — | — e.g. 264.8000 |
total_goal_fpts | decimal | — | — e.g. 42.5000 |
total_goalie_win_fpts | decimal | — | — e.g. 6.0000 |
total_goals_against_fpts | decimal | — | — e.g. -28.0000 |
total_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
total_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
total_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
total_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
total_save_fpts | decimal | — | — e.g. 39.2000 |
total_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
total_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_shot_on_goal_fpts | decimal | — | — e.g. 96.0000 |
total_shutout_fpts | decimal | — | — e.g. 0.0000 |
GET/api/v1/nhl/operator_game_fantasy_stats/{id}Get a single operator_game_fantasy_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_game_fantasy_stat 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/operator_game_fantasy_stats/{pk_value}'Responses
200Single operator_game_fantasy_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(65 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
operator_id | bigint | — e.g. 1 | |
operator_scoring_format_id | bigint | — | — e.g. 2 |
away_assist_fpts | decimal | — | — e.g. 40.0000 |
away_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
away_blocked_shot_fpts | decimal | — | — e.g. 20.8000 |
away_fpts | decimal | — | — e.g. 125.6000 |
away_goal_fpts | decimal | — | — e.g. 25.5000 |
away_goalie_win_fpts | decimal | — | — e.g. 0.0000 |
away_goals_against_fpts | decimal | — | — e.g. -10.5000 |
away_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
away_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
away_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
away_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
away_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
away_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
away_save_fpts | decimal | — | — e.g. 22.4000 |
away_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
away_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
away_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
away_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
away_shot_on_goal_fpts | decimal | — | — e.g. 48.0000 |
away_shutout_fpts | decimal | — | — e.g. 0.0000 |
home_assist_fpts | decimal | — | — e.g. 40.0000 |
home_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
home_blocked_shot_fpts | decimal | — | — e.g. 20.8000 |
home_fpts | decimal | — | — e.g. 133.6000 |
home_goal_fpts | decimal | — | — e.g. 25.5000 |
home_goalie_win_fpts | decimal | — | — e.g. 0.0000 |
home_goals_against_fpts | decimal | — | — e.g. -10.5000 |
home_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
home_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
home_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
home_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
home_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
home_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
home_save_fpts | decimal | — | — e.g. 22.4000 |
home_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
home_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
home_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
home_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
home_shot_on_goal_fpts | decimal | — | — e.g. 48.0000 |
home_shutout_fpts | decimal | — | — e.g. 0.0000 |
player_count | integer | — | — e.g. 40 |
total_assist_fpts | decimal | — | — e.g. 40.0000 |
total_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_blocked_shot_fpts | decimal | — | — e.g. 41.6000 |
total_fpts | decimal | — | — e.g. 264.8000 |
total_goal_fpts | decimal | — | — e.g. 42.5000 |
total_goalie_win_fpts | decimal | — | — e.g. 6.0000 |
total_goals_against_fpts | decimal | — | — e.g. -28.0000 |
total_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
total_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
total_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
total_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
total_save_fpts | decimal | — | — e.g. 39.2000 |
total_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
total_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_shot_on_goal_fpts | decimal | — | — e.g. 96.0000 |
total_shutout_fpts | decimal | — | — e.g. 0.0000 |
operator_player_fantasy_stats
nhl.operator_player_fantasy_statsEach NHL player's fantasy point total for each game, scored under each fantasy operator's specific scoring rules.
GET/api/v1/nhl/operator_player_fantasy_statsList operator_player_fantasy_stats for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player.
operator_idquerybigintoptionalFilter by operator.
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/operator_player_fantasy_stats?game_id=1'Responses
200operator_player_fantasy_stats rows matching the declared filter set, wrapped in { operator_player_fantasy_stats, 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(25 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
operator_id | bigint | — e.g. 1 | |
operator_scoring_format_id | bigint | — | — e.g. 2 |
player_id | bigint | — e.g. 103 | |
assist_fpts | decimal | — | — e.g. 0.0000 |
block_bonus_fpts | decimal | — | Bonus for 3+ blocked shots e.g. 0.0000 |
blocked_shot_fpts | decimal | — | — e.g. 0.0000 |
fantasy_pts | decimal | — | — e.g. 0.0000 |
goal_fpts | decimal | — | — e.g. 0.0000 |
goalie_win_fpts | decimal | — | — e.g. 0.0000 |
goals_against_fpts | decimal | — | Negative points for goals allowed e.g. 0.0000 |
hat_trick_fpts | decimal | — | Bonus for 3+ goals e.g. 0.0000 |
overtime_loss_fpts | decimal | — | DK: +2 for OT loss e.g. 0.0000 |
penalty_minutes_fpts | decimal | — | Typically negative or zero e.g. 0.0000 |
plus_minus_fpts | decimal | — | — e.g. 0.0000 |
power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
save_fpts | decimal | — | — e.g. 0.0000 |
shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
shot_bonus_fpts | decimal | — | Bonus for 5+ shots on goal e.g. 0.0000 |
shot_on_goal_fpts | decimal | — | — e.g. 0.0000 |
shutout_fpts | decimal | — | — e.g. 0.0000 |
GET/api/v1/nhl/operator_player_fantasy_stats/{id}Get a single operator_player_fantasy_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_player_fantasy_stat 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/operator_player_fantasy_stats/{pk_value}'Responses
200Single operator_player_fantasy_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(25 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
operator_id | bigint | — e.g. 1 | |
operator_scoring_format_id | bigint | — | — e.g. 2 |
player_id | bigint | — e.g. 103 | |
assist_fpts | decimal | — | — e.g. 0.0000 |
block_bonus_fpts | decimal | — | Bonus for 3+ blocked shots e.g. 0.0000 |
blocked_shot_fpts | decimal | — | — e.g. 0.0000 |
fantasy_pts | decimal | — | — e.g. 0.0000 |
goal_fpts | decimal | — | — e.g. 0.0000 |
goalie_win_fpts | decimal | — | — e.g. 0.0000 |
goals_against_fpts | decimal | — | Negative points for goals allowed e.g. 0.0000 |
hat_trick_fpts | decimal | — | Bonus for 3+ goals e.g. 0.0000 |
overtime_loss_fpts | decimal | — | DK: +2 for OT loss e.g. 0.0000 |
penalty_minutes_fpts | decimal | — | Typically negative or zero e.g. 0.0000 |
plus_minus_fpts | decimal | — | — e.g. 0.0000 |
power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
save_fpts | decimal | — | — e.g. 0.0000 |
shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
shot_bonus_fpts | decimal | — | Bonus for 5+ shots on goal e.g. 0.0000 |
shot_on_goal_fpts | decimal | — | — e.g. 0.0000 |
shutout_fpts | decimal | — | — e.g. 0.0000 |
operator_player_lookups
nhl.operator_player_lookupsHow each sportsbook and fantasy operator names every NHL player — the mapping from each operator's player identifier to a unified player record.
GET/api/v1/nhl/operator_player_lookupsList operator_player_lookups for NHL
Requires one of:
operator_id — requests satisfying none of these return 400.Parameters
operator_idquerybigintoptionalFilter by operator.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; 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/operator_player_lookups?operator_id=1'Responses
200operator_player_lookups rows matching the declared filter set, wrapped in { operator_player_lookups, 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(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 1 | |
operator_player_id | string | — | External player ID from operator e.g. 8478042 |
player_id | bigintnullable | Internal nhl.players.id reference e.g. 404 | |
decided_at | timestamptznullable | — | When the pin or block was decided. e.g. 2026-08-19T22:09:48.576Z |
decided_reason | stringnullable | — | Evidence behind a pinned or blocked decision. Values:6740 "C. Schneider" is …7321 "C. Fitzgerald", n…Same human as DK 269241…6585 "R. Carpenter" is …Same human as DK 136307…Mirror names this id Co…7153 "M. Phillips" is a…Mirror names this id Ma…Mirror names this id Ca…Mirror names this id Da…Mirror names this id Du…Same human as DK 651123…Same human as DK 920505…Same human as DK 105722…Same human as DK 920402…Same human as DK 894729…Same human as DK 554479…Mirror names this id Ro…7049 "G. Smith" (C, nhl…6912 "G. Smith" (RW, nh… |
decision | stringnullable | — | How this mapping was decided: 'derived' (finder answer, overwritable), 'pinned' (decided on evidence, trigger-protected), 'blocked' (no player we hold is this id; player_id NULL, never retried). DB default 'derived'; a BEFORE UPDATE trigger preserves non-derived rows. Values:derivedpinnedblocked |
player_name | stringnullable | — | Player name for reconciliation e.g. Alex Tuch |
position | stringnullable | — | Position for reconciliation Values:DCWGRWLW |
GET/api/v1/nhl/operator_player_lookups/{id}Get a single operator_player_lookup by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_player_lookup 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/operator_player_lookups/{pk_value}'Responses
200Single operator_player_lookup row.application/jsonshow example ▸
404Row not found.
Response Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 1 | |
operator_player_id | string | — | External player ID from operator e.g. 8478042 |
player_id | bigintnullable | Internal nhl.players.id reference e.g. 404 | |
decided_at | timestamptznullable | — | When the pin or block was decided. e.g. 2026-08-19T22:09:48.576Z |
decided_reason | stringnullable | — | Evidence behind a pinned or blocked decision. Values:6740 "C. Schneider" is …7321 "C. Fitzgerald", n…Same human as DK 269241…6585 "R. Carpenter" is …Same human as DK 136307…Mirror names this id Co…7153 "M. Phillips" is a…Mirror names this id Ma…Mirror names this id Ca…Mirror names this id Da…Mirror names this id Du…Same human as DK 651123…Same human as DK 920505…Same human as DK 105722…Same human as DK 920402…Same human as DK 894729…Same human as DK 554479…Mirror names this id Ro…7049 "G. Smith" (C, nhl…6912 "G. Smith" (RW, nh… |
decision | stringnullable | — | How this mapping was decided: 'derived' (finder answer, overwritable), 'pinned' (decided on evidence, trigger-protected), 'blocked' (no player we hold is this id; player_id NULL, never retried). DB default 'derived'; a BEFORE UPDATE trigger preserves non-derived rows. Values:derivedpinnedblocked |
player_name | stringnullable | — | Player name for reconciliation e.g. Alex Tuch |
position | stringnullable | — | Position for reconciliation Values:DCWGRWLW |
operator_team_fantasy_stats
nhl.operator_team_fantasy_statsEach NHL team's fantasy point total for each game under each fantasy operator's scoring rules.
GET/api/v1/nhl/operator_team_fantasy_statsList operator_team_fantasy_stats for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
operator_idquerybigintoptionalFilter by operator.
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/operator_team_fantasy_stats?game_id=1'Responses
200operator_team_fantasy_stats rows matching the declared filter set, wrapped in { operator_team_fantasy_stats, 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(26 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
operator_id | bigint | — e.g. 1 | |
operator_scoring_format_id | bigint | — | — e.g. 2 |
team_id | bigint | — e.g. 2 | |
player_count | integer | — | — e.g. 20 |
total_assist_fpts | decimal | — | — e.g. 40.0000 |
total_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_blocked_shot_fpts | decimal | — | — e.g. 20.8000 |
total_fpts | decimal | — | — e.g. 175.2000 |
total_goal_fpts | decimal | — | — e.g. 25.5000 |
total_goalie_win_fpts | decimal | — | — e.g. 0.0000 |
total_goals_against_fpts | decimal | — | — e.g. -10.5000 |
total_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
total_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
total_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
total_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
total_save_fpts | decimal | — | — e.g. 22.4000 |
total_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
total_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_shot_on_goal_fpts | decimal | — | — e.g. 48.0000 |
total_shutout_fpts | decimal | — | — e.g. 0.0000 |
GET/api/v1/nhl/operator_team_fantasy_stats/{id}Get a single operator_team_fantasy_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_team_fantasy_stat 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/operator_team_fantasy_stats/{pk_value}'Responses
200Single operator_team_fantasy_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(26 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
operator_id | bigint | — e.g. 1 | |
operator_scoring_format_id | bigint | — | — e.g. 2 |
team_id | bigint | — e.g. 2 | |
player_count | integer | — | — e.g. 20 |
total_assist_fpts | decimal | — | — e.g. 40.0000 |
total_block_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_blocked_shot_fpts | decimal | — | — e.g. 20.8000 |
total_fpts | decimal | — | — e.g. 175.2000 |
total_goal_fpts | decimal | — | — e.g. 25.5000 |
total_goalie_win_fpts | decimal | — | — e.g. 0.0000 |
total_goals_against_fpts | decimal | — | — e.g. -10.5000 |
total_hat_trick_fpts | decimal | — | — e.g. 0.0000 |
total_overtime_loss_fpts | decimal | — | — e.g. 0.0000 |
total_penalty_minutes_fpts | decimal | — | — e.g. 0.0000 |
total_plus_minus_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_assist_fpts | decimal | — | — e.g. 0.0000 |
total_power_play_goal_fpts | decimal | — | — e.g. 0.0000 |
total_save_fpts | decimal | — | — e.g. 22.4000 |
total_shootout_goal_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_assist_fpts | decimal | — | — e.g. 0.0000 |
total_short_handed_goal_fpts | decimal | — | — e.g. 0.0000 |
total_shot_bonus_fpts | decimal | — | — e.g. 0.0000 |
total_shot_on_goal_fpts | decimal | — | — e.g. 48.0000 |
total_shutout_fpts | decimal | — | — e.g. 0.0000 |
season_player_stats
nhl.season_player_statsSeason totals for each NHL player — goals, assists, points, plus-minus, shots on goal, hits, blocks, penalty minutes, power-play and short-handed contributions, plus goaltender stats (wins, saves, shutouts, save percentage, goals-against average).
GET/api/v1/nhl/season_player_statsList season_player_stats for NHL
Requires one of:
season_id or player_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
player_idquerybigintoptionalFilter to a single player.
team_idquerybigintoptionalFilter by team.
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/season_player_stats?season_id=2026'Responses
200season_player_stats rows matching the declared filter set, wrapped in { season_player_stats, 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(62 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 6 | |
season_id | bigint | — e.g. 2021 | |
team_id | bigintnullable | — e.g. 22 | |
assists | integer | — | — e.g. 0 |
assists_per_game | decimal | — | — e.g. 0.0000 |
blocked_shots | integer | — | — e.g. 0 |
empty_net_goals | integer | — | — e.g. 0 |
even_strength_assists | integer | — | — e.g. 0 |
even_strength_goals | integer | — | — e.g. 0 |
even_strength_time_on_ice_seconds | integer | — | — e.g. 0 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoffs_lost | integer | — | — e.g. 0 |
faceoffs_won | integer | — | — e.g. 0 |
game_winning_goals | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 4 |
games_started | integer | — | — e.g. 0 |
giveaways | integer | — | — e.g. 0 |
goals | integer | — | — e.g. 0 |
goals_against | integer | — | — e.g. 0 |
goals_against_average | decimal | — | — e.g. 0.0000 |
goals_per_game | decimal | — | — e.g. 0.0000 |
hat_tricks | integer | — | — e.g. 0 |
hits | integer | — | — e.g. 0 |
losses | integer | — | — e.g. 0 |
major_penalties | integer | — | — e.g. 0 |
minor_penalties | integer | — | — e.g. 0 |
minutes_played | integer | — | — e.g. 0 |
overtime_goals | integer | — | — e.g. 0 |
overtime_losses | integer | — | — e.g. 0 |
penalties | integer | — | — e.g. 0 |
penalty_minutes | integer | — | — e.g. 0 |
plus_minus | integer | — | — e.g. 0 |
position | stringnullable | — | — e.g. — (all-null in sample) |
power_play_assists | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_pts | integer | — | — e.g. 0 |
power_play_time_on_ice_seconds | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
pts_per_game | decimal | — | — e.g. 0.0000 |
save_percentage | decimal | — | — e.g. 0.0000 |
saves | integer | — | — e.g. 0 |
season_type | string | — | Canonical season phase (text). Was integer 1/2/3 before the 2026-06-29 normalization. Values:regular_seasonpreseasonpostseason |
shifts | integer | — | — e.g. 0 |
shooting_percentage | decimal | — | — e.g. 0.0000 |
shootout_attempts | integer | — | — e.g. 0 |
shootout_goals | integer | — | — e.g. 0 |
shootout_goals_against | integer | — | — e.g. 0 |
shootout_misses | integer | — | — e.g. 0 |
shootout_saves | integer | — | — e.g. 0 |
short_handed_assists | integer | — | — e.g. 0 |
short_handed_goals | integer | — | — e.g. 0 |
short_handed_pts | integer | — | — e.g. 0 |
short_handed_time_on_ice_seconds | integer | — | — e.g. 0 |
shots | integer | — | — e.g. 0 |
shots_against | integer | — | — e.g. 0 |
shots_on_goal | integer | — | — e.g. 0 |
shutouts | integer | — | — e.g. 0 |
takeaways | integer | — | — e.g. 0 |
time_on_ice_per_game | decimal | — | — e.g. 0.0000 |
time_on_ice_seconds | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 0 |
GET/api/v1/nhl/season_player_stats/{id}Get a single season_player_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the season_player_stat 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/season_player_stats/{pk_value}'Responses
200Single season_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(62 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 6 | |
season_id | bigint | — e.g. 2021 | |
team_id | bigintnullable | — e.g. 22 | |
assists | integer | — | — e.g. 0 |
assists_per_game | decimal | — | — e.g. 0.0000 |
blocked_shots | integer | — | — e.g. 0 |
empty_net_goals | integer | — | — e.g. 0 |
even_strength_assists | integer | — | — e.g. 0 |
even_strength_goals | integer | — | — e.g. 0 |
even_strength_time_on_ice_seconds | integer | — | — e.g. 0 |
faceoff_percentage | decimal | — | — e.g. 0.0000 |
faceoffs_lost | integer | — | — e.g. 0 |
faceoffs_won | integer | — | — e.g. 0 |
game_winning_goals | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 4 |
games_started | integer | — | — e.g. 0 |
giveaways | integer | — | — e.g. 0 |
goals | integer | — | — e.g. 0 |
goals_against | integer | — | — e.g. 0 |
goals_against_average | decimal | — | — e.g. 0.0000 |
goals_per_game | decimal | — | — e.g. 0.0000 |
hat_tricks | integer | — | — e.g. 0 |
hits | integer | — | — e.g. 0 |
losses | integer | — | — e.g. 0 |
major_penalties | integer | — | — e.g. 0 |
minor_penalties | integer | — | — e.g. 0 |
minutes_played | integer | — | — e.g. 0 |
overtime_goals | integer | — | — e.g. 0 |
overtime_losses | integer | — | — e.g. 0 |
penalties | integer | — | — e.g. 0 |
penalty_minutes | integer | — | — e.g. 0 |
plus_minus | integer | — | — e.g. 0 |
position | stringnullable | — | — e.g. — (all-null in sample) |
power_play_assists | integer | — | — e.g. 0 |
power_play_goals | integer | — | — e.g. 0 |
power_play_pts | integer | — | — e.g. 0 |
power_play_time_on_ice_seconds | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
pts_per_game | decimal | — | — e.g. 0.0000 |
save_percentage | decimal | — | — e.g. 0.0000 |
saves | integer | — | — e.g. 0 |
season_type | string | — | Canonical season phase (text). Was integer 1/2/3 before the 2026-06-29 normalization. Values:regular_seasonpreseasonpostseason |
shifts | integer | — | — e.g. 0 |
shooting_percentage | decimal | — | — e.g. 0.0000 |
shootout_attempts | integer | — | — e.g. 0 |
shootout_goals | integer | — | — e.g. 0 |
shootout_goals_against | integer | — | — e.g. 0 |
shootout_misses | integer | — | — e.g. 0 |
shootout_saves | integer | — | — e.g. 0 |
short_handed_assists | integer | — | — e.g. 0 |
short_handed_goals | integer | — | — e.g. 0 |
short_handed_pts | integer | — | — e.g. 0 |
short_handed_time_on_ice_seconds | integer | — | — e.g. 0 |
shots | integer | — | — e.g. 0 |
shots_against | integer | — | — e.g. 0 |
shots_on_goal | integer | — | — e.g. 0 |
shutouts | integer | — | — e.g. 0 |
takeaways | integer | — | — e.g. 0 |
time_on_ice_per_game | decimal | — | — e.g. 0.0000 |
time_on_ice_seconds | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 0 |
Projections
projected_player_stats
nhl.projected_player_statsOur projection of each NHL player in each game before puck drop — the chance to play and to start, the ice time with its range, the power-play and short-handed time, goals, assists, shots on goal, blocked shots, the power-play and short-handed goals and assists, shootout goals, and the goalie line (win, saves, goals against, shutout, overtime loss), with the chance of each bonus threshold. One current row per game, player and engine version, the same stat line for every DFS operator; it updates until puck drop and never changes after. GET /api/v1/dfs/slates/{slate_id}/projections serves this stat line for every seat of a DFS slate with its fantasy points.
GET/api/v1/nhl/projected_player_statsList projected_player_stats for NHL
Requires one of:
game_id or player_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player.
team_idquerybigintoptionalFilter by team.
projection_idquerybigintoptionalFilter by engine version (one id per version of our NHL engine).
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; 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/projected_player_stats?game_id=1'Responses
200projected_player_stats rows matching the declared filter set, wrapped in { projected_player_stats, 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(43 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 21037 | |
player_id | bigint | — e.g. 351 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NHL 1.0). e.g. 4 |
team_id | bigint | — e.g. 8 | |
a | float | — | Projected assists (mean). e.g. 0 |
blk | float | — | Projected blocked shots (mean). e.g. 0 |
blocks_3_probability | float | — | Chance of 3 or more blocked shots, 0 to 1. e.g. 0 |
g | float | — | Projected goals (mean), regulation and overtime; a shootout goal is so_g. e.g. 0 |
ga | float | — | Projected goals against (mean; 0 for a skater). e.g. 0 |
hat_trick_probability | float | — | Chance of 3 or more goals, 0 to 1. e.g. 0 |
injury_tag | stringnullable | — | The injury tag of the lineup reading (IR, DTD, ...); null when none. Values:IRIR-LTOUTIR-NRDTD |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's puck drop. e.g. 2026-11-14T23:58:05.827Z |
lineup_captured_at | timestamptznullable | — | When the lineup reading the projection used was captured (UTC); null when no reading was in. e.g. 2026-11-18T13:02:04.647Z |
lineup_unit | stringnullable | — | The player's unit in the lineup reading the projection used — a forward line (line1 to line4), a defensive pairing (pair1 to pair3), a power-play unit (pp1, pp2), goalie or injured; null when no lineup reading was in. Values:injuredline1line3line2pair1pair2pair3goaliepp2pp1 |
minutes_mean | float | — | Projected time on ice, minutes (mean). e.g. 0 |
minutes_p10 | float | — | Projected time on ice, 10th percentile, minutes. e.g. 0 |
minutes_p25 | float | — | Projected time on ice, 25th percentile, minutes. e.g. 0 |
minutes_p50 | float | — | Projected time on ice, median, minutes. e.g. 0 |
minutes_p75 | float | — | Projected time on ice, 75th percentile, minutes. e.g. 0 |
minutes_p90 | float | — | Projected time on ice, 90th percentile, minutes. e.g. 0 |
minutes_std | float | — | Standard deviation of the projected time on ice, minutes. e.g. 0 |
otl | float | — | Chance the goalie is charged with the overtime loss, 0 to 1 (0 for a skater). e.g. 0 |
play_probability | float | — | Chance the player plays (dresses for the game), 0 to 1. e.g. 0 |
points_3_probability | float | — | Chance of 3 or more points (goals plus assists), 0 to 1. e.g. 0 |
position | string | — | The player's position in our engine for this game — C, W, D or G. Values:DWCG |
pp_minutes_mean | float | — | Projected power-play time on ice, minutes (mean). e.g. 0 |
ppa | float | — | Projected power-play assists (mean), a part of a. e.g. 0 |
ppg | float | — | Projected power-play goals (mean), a part of g. e.g. 0 |
relief_probability | float | — | Chance the goalie enters in relief, 0 to 1 (0 for a skater). e.g. 0 |
saves_35_probability | float | — | Chance of 35 or more saves, 0 to 1. e.g. 0 |
sh_minutes_mean | float | — | Projected short-handed time on ice, minutes (mean). e.g. 0 |
sha | float | — | Projected short-handed assists (mean), a part of a. e.g. 0 |
shg | float | — | Projected short-handed goals (mean), a part of g. e.g. 0 |
shots_5_probability | float | — | Chance of 5 or more shots on goal, 0 to 1. e.g. 0 |
so | float | — | Chance of a shutout, 0 to 1 (0 for a skater). e.g. 0 |
so_g | float | — | Projected shootout goals (mean). e.g. 0 |
sog | float | — | Projected shots on goal (mean). e.g. 0 |
start_probability | float | — | Chance the player starts, 0 to 1 (a goalie's chance to start in net). e.g. 0 |
stat_quantiles | jsonb | — | The 10th percentile, median and 90th percentile of each projected stat, keyed by stat name (g, a, sog, blk, ppg, ppa, shg, sha, so_g, w, sv, ga, so, otl), each an object of p10, p50 and p90. e.g. {"a":{"p10":0,"p50":0,"p90":0},"blk":{"p10":0,"p50":0,"p90"… |
sv | float | — | Projected saves (mean; 0 for a skater). e.g. 0 |
w | float | — | Chance the goalie is credited with the win, 0 to 1 (0 for a skater). e.g. 0 |
zero_reason | stringnullable | — | Why the player projects no ice time (injured, or not dressed for the game); null for a player who may play. Values:injurednot_dressed |
GET/api/v1/nhl/projected_player_stats/{id}Get a single projected_player_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the projected_player_stat 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/projected_player_stats/{pk_value}'Responses
200Single projected_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(43 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 21037 | |
player_id | bigint | — e.g. 351 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NHL 1.0). e.g. 4 |
team_id | bigint | — e.g. 8 | |
a | float | — | Projected assists (mean). e.g. 0 |
blk | float | — | Projected blocked shots (mean). e.g. 0 |
blocks_3_probability | float | — | Chance of 3 or more blocked shots, 0 to 1. e.g. 0 |
g | float | — | Projected goals (mean), regulation and overtime; a shootout goal is so_g. e.g. 0 |
ga | float | — | Projected goals against (mean; 0 for a skater). e.g. 0 |
hat_trick_probability | float | — | Chance of 3 or more goals, 0 to 1. e.g. 0 |
injury_tag | stringnullable | — | The injury tag of the lineup reading (IR, DTD, ...); null when none. Values:IRIR-LTOUTIR-NRDTD |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's puck drop. e.g. 2026-11-14T23:58:05.827Z |
lineup_captured_at | timestamptznullable | — | When the lineup reading the projection used was captured (UTC); null when no reading was in. e.g. 2026-11-18T13:02:04.647Z |
lineup_unit | stringnullable | — | The player's unit in the lineup reading the projection used — a forward line (line1 to line4), a defensive pairing (pair1 to pair3), a power-play unit (pp1, pp2), goalie or injured; null when no lineup reading was in. Values:injuredline1line3line2pair1pair2pair3goaliepp2pp1 |
minutes_mean | float | — | Projected time on ice, minutes (mean). e.g. 0 |
minutes_p10 | float | — | Projected time on ice, 10th percentile, minutes. e.g. 0 |
minutes_p25 | float | — | Projected time on ice, 25th percentile, minutes. e.g. 0 |
minutes_p50 | float | — | Projected time on ice, median, minutes. e.g. 0 |
minutes_p75 | float | — | Projected time on ice, 75th percentile, minutes. e.g. 0 |
minutes_p90 | float | — | Projected time on ice, 90th percentile, minutes. e.g. 0 |
minutes_std | float | — | Standard deviation of the projected time on ice, minutes. e.g. 0 |
otl | float | — | Chance the goalie is charged with the overtime loss, 0 to 1 (0 for a skater). e.g. 0 |
play_probability | float | — | Chance the player plays (dresses for the game), 0 to 1. e.g. 0 |
points_3_probability | float | — | Chance of 3 or more points (goals plus assists), 0 to 1. e.g. 0 |
position | string | — | The player's position in our engine for this game — C, W, D or G. Values:DWCG |
pp_minutes_mean | float | — | Projected power-play time on ice, minutes (mean). e.g. 0 |
ppa | float | — | Projected power-play assists (mean), a part of a. e.g. 0 |
ppg | float | — | Projected power-play goals (mean), a part of g. e.g. 0 |
relief_probability | float | — | Chance the goalie enters in relief, 0 to 1 (0 for a skater). e.g. 0 |
saves_35_probability | float | — | Chance of 35 or more saves, 0 to 1. e.g. 0 |
sh_minutes_mean | float | — | Projected short-handed time on ice, minutes (mean). e.g. 0 |
sha | float | — | Projected short-handed assists (mean), a part of a. e.g. 0 |
shg | float | — | Projected short-handed goals (mean), a part of g. e.g. 0 |
shots_5_probability | float | — | Chance of 5 or more shots on goal, 0 to 1. e.g. 0 |
so | float | — | Chance of a shutout, 0 to 1 (0 for a skater). e.g. 0 |
so_g | float | — | Projected shootout goals (mean). e.g. 0 |
sog | float | — | Projected shots on goal (mean). e.g. 0 |
start_probability | float | — | Chance the player starts, 0 to 1 (a goalie's chance to start in net). e.g. 0 |
stat_quantiles | jsonb | — | The 10th percentile, median and 90th percentile of each projected stat, keyed by stat name (g, a, sog, blk, ppg, ppa, shg, sha, so_g, w, sv, ga, so, otl), each an object of p10, p50 and p90. e.g. {"a":{"p10":0,"p50":0,"p90":0},"blk":{"p10":0,"p50":0,"p90"… |
sv | float | — | Projected saves (mean; 0 for a skater). e.g. 0 |
w | float | — | Chance the goalie is credited with the win, 0 to 1 (0 for a skater). e.g. 0 |
zero_reason | stringnullable | — | Why the player projects no ice time (injured, or not dressed for the game); null for a player who may play. Values:injurednot_dressed |
projected_team_stats
nhl.projected_team_statsOur projection of each NHL team in each game before puck drop — goals with their range, shots on goal, power-play time, win, overtime and shootout chances, and the betting lines the projection used. One current row per game, team and engine version; it updates until puck drop and never changes after. GET /api/v1/dfs/slates/{slate_id}/projections serves the same rows in its `teams` block for the games of a DFS slate.
GET/api/v1/nhl/projected_team_statsList projected_team_stats for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
projection_idquerybigintoptionalFilter by engine version (one id per version of our NHL engine).
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 1000.
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/projected_team_stats?game_id=1'Responses
200projected_team_stats rows matching the declared filter set, wrapped in { projected_team_stats, 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(29 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 19958 | |
opponent_team_id | bigint | The team this team plays in the game. e.g. 2 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NHL 1.0). e.g. 4 |
team_id | bigint | — e.g. 2 | |
empty_net_goals_mean | float | — | Projected empty-net goals this team scores (mean). e.g. 0.14 |
goals_mean | float | — | Projected goals this team scores in regulation and overtime (mean); a shootout goal is not a goal. e.g. 3.589 |
goals_p10 | float | — | This team's projected goals, 10th percentile. e.g. 1 |
goals_p25 | float | — | This team's projected goals, 25th percentile. e.g. 2 |
goals_p50 | float | — | This team's projected goals, median. e.g. 3 |
goals_p75 | float | — | This team's projected goals, 75th percentile. e.g. 4 |
goals_p90 | float | — | This team's projected goals, 90th percentile. e.g. 5 |
goals_std | float | — | Standard deviation of this team's projected goals. e.g. 1.9545022384228676 |
implied_team_total | floatnullable | — | This team's implied goals from the betting total and moneyline; null when no line was captured. e.g. 3.3933218293227236 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's puck drop. e.g. 2026-11-06T23:55:02.842Z |
is_home | boolean | — | True when this team is the home team. Values:truefalse |
lines_captured_at | timestamptznullable | — | When the betting lines the projection used were captured (UTC). e.g. 2026-11-06T23:55:02.202Z |
opponent_goals_mean | float | — | Projected goals the opponent scores (mean). e.g. 3.589 |
overtime_probability | float | — | Chance the game goes to overtime, 0 to 1. e.g. 0.171 |
power_play_minutes_mean | float | — | Projected power-play time of this team, minutes (mean). e.g. 5.475 |
shootout_probability | float | — | Chance the game goes to a shootout, 0 to 1 (at most overtime_probability). e.g. 0.057 |
sog_mean | float | — | Projected team shots on goal (mean). e.g. 26.389 |
sog_p10 | float | — | Projected team shots on goal, 10th percentile. e.g. 19 |
sog_p50 | float | — | Projected team shots on goal, median. e.g. 26 |
sog_p90 | float | — | Projected team shots on goal, 90th percentile. e.g. 35 |
vegas_moneyline | integernullable | — | This team's betting moneyline that the projection used, in American odds; null when no line was captured. e.g. -110 |
vegas_spread | floatnullable | — | Betting puck line from this team's side that the projection used; null when no line was captured. e.g. -1.5 |
vegas_total | floatnullable | — | Betting game total the projection used; null when no line was captured before the projection. e.g. 6.5 |
win_probability | float | — | Chance this team wins, 0 to 1 (0.62 = 62%). e.g. 0.61 |
GET/api/v1/nhl/projected_team_stats/{id}Get a single projected_team_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the projected_team_stat 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/projected_team_stats/{pk_value}'Responses
200Single projected_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(29 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 19958 | |
opponent_team_id | bigint | The team this team plays in the game. e.g. 2 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NHL 1.0). e.g. 4 |
team_id | bigint | — e.g. 2 | |
empty_net_goals_mean | float | — | Projected empty-net goals this team scores (mean). e.g. 0.14 |
goals_mean | float | — | Projected goals this team scores in regulation and overtime (mean); a shootout goal is not a goal. e.g. 3.589 |
goals_p10 | float | — | This team's projected goals, 10th percentile. e.g. 1 |
goals_p25 | float | — | This team's projected goals, 25th percentile. e.g. 2 |
goals_p50 | float | — | This team's projected goals, median. e.g. 3 |
goals_p75 | float | — | This team's projected goals, 75th percentile. e.g. 4 |
goals_p90 | float | — | This team's projected goals, 90th percentile. e.g. 5 |
goals_std | float | — | Standard deviation of this team's projected goals. e.g. 1.9545022384228676 |
implied_team_total | floatnullable | — | This team's implied goals from the betting total and moneyline; null when no line was captured. e.g. 3.3933218293227236 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's puck drop. e.g. 2026-11-06T23:55:02.842Z |
is_home | boolean | — | True when this team is the home team. Values:truefalse |
lines_captured_at | timestamptznullable | — | When the betting lines the projection used were captured (UTC). e.g. 2026-11-06T23:55:02.202Z |
opponent_goals_mean | float | — | Projected goals the opponent scores (mean). e.g. 3.589 |
overtime_probability | float | — | Chance the game goes to overtime, 0 to 1. e.g. 0.171 |
power_play_minutes_mean | float | — | Projected power-play time of this team, minutes (mean). e.g. 5.475 |
shootout_probability | float | — | Chance the game goes to a shootout, 0 to 1 (at most overtime_probability). e.g. 0.057 |
sog_mean | float | — | Projected team shots on goal (mean). e.g. 26.389 |
sog_p10 | float | — | Projected team shots on goal, 10th percentile. e.g. 19 |
sog_p50 | float | — | Projected team shots on goal, median. e.g. 26 |
sog_p90 | float | — | Projected team shots on goal, 90th percentile. e.g. 35 |
vegas_moneyline | integernullable | — | This team's betting moneyline that the projection used, in American odds; null when no line was captured. e.g. -110 |
vegas_spread | floatnullable | — | Betting puck line from this team's side that the projection used; null when no line was captured. e.g. -1.5 |
vegas_total | floatnullable | — | Betting game total the projection used; null when no line was captured before the projection. e.g. 6.5 |
win_probability | float | — | Chance this team wins, 0 to 1 (0.62 = 62%). e.g. 0.61 |
Odds
game_lines
nhl.game_linesNHL game betting lines — moneylines, puck lines (the hockey point spread) and over/under totals, the consensus of the main sportsbooks, captured over time from the opening line to the close before puck drop.
GET/api/v1/nhl/game_linesList game_lines for NHL
Requires one of:
game_id or season_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
season_idquerybigintoptionalFilter by season.
is_openingquerybooleanoptionalFilter to opening lines only.
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/game_lines?game_id=1'Responses
200game_lines rows matching the declared filter set, wrapped in { game_lines, 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(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 20339 | |
operator_id | bigint | Sportsbook id: 6 Consensus. e.g. 6 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2026 | |
book_count | integernullable | — | Number of sportsbooks in the consensus e.g. 6 |
captured_at | timestamptz | — | When this line was captured (always before puck drop) e.g. 2021-10-15T02:25:00.000Z |
implied_away_score | decimalnullable | — | — e.g. — (all-null in sample) |
implied_away_win_pct | decimalnullable | — | — e.g. 0.5 |
implied_home_score | decimalnullable | — | — e.g. — (all-null in sample) |
implied_home_win_pct | decimalnullable | — | From the moneyline, 0-1 e.g. 0.5 |
is_opening | boolean | — | True for the first line captured for the game Values:falsetrue |
moneyline_away | integernullable | — | American odds for an away win e.g. -110 |
moneyline_home | integernullable | — | American odds for a home win e.g. -110 |
over_odds | integernullable | — | — e.g. -120 |
spread | decimalnullable | — | Home team puck line (e.g., -1.5 means home favored by 1.5 goals) e.g. -1.5 |
spread_away_odds | integernullable | — | American odds for the away puck line e.g. 210 |
spread_home_odds | integernullable | — | American odds for the home puck line e.g. 210 |
total | decimalnullable | — | Combined goals total line (e.g., 6.5) e.g. 6.5 |
under_odds | integernullable | — | — e.g. 100 |
GET/api/v1/nhl/game_lines/{id}Get a single game_line by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_line 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/game_lines/{pk_value}'Responses
200Single game_line row.application/jsonshow example ▸
404Row not found.
Response Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 20339 | |
operator_id | bigint | Sportsbook id: 6 Consensus. e.g. 6 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2026 | |
book_count | integernullable | — | Number of sportsbooks in the consensus e.g. 6 |
captured_at | timestamptz | — | When this line was captured (always before puck drop) e.g. 2021-10-15T02:25:00.000Z |
implied_away_score | decimalnullable | — | — e.g. — (all-null in sample) |
implied_away_win_pct | decimalnullable | — | — e.g. 0.5 |
implied_home_score | decimalnullable | — | — e.g. — (all-null in sample) |
implied_home_win_pct | decimalnullable | — | From the moneyline, 0-1 e.g. 0.5 |
is_opening | boolean | — | True for the first line captured for the game Values:falsetrue |
moneyline_away | integernullable | — | American odds for an away win e.g. -110 |
moneyline_home | integernullable | — | American odds for a home win e.g. -110 |
over_odds | integernullable | — | — e.g. -120 |
spread | decimalnullable | — | Home team puck line (e.g., -1.5 means home favored by 1.5 goals) e.g. -1.5 |
spread_away_odds | integernullable | — | American odds for the away puck line e.g. 210 |
spread_home_odds | integernullable | — | American odds for the home puck line e.g. 210 |
total | decimalnullable | — | Combined goals total line (e.g., 6.5) e.g. 6.5 |
under_odds | integernullable | — | — e.g. 100 |
game_period_lines
nhl.game_period_linesNHL period betting lines — moneyline, puck line and total for the 1st, 2nd and 3rd period, the consensus of the main sportsbooks, captured before puck drop.
GET/api/v1/nhl/game_period_linesList game_period_lines for NHL
Requires one of:
game_id or season_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
season_idquerybigintoptionalFilter by season.
period_codequerystringoptionalFilter by period: p1, p2 or p3. Values: p1, p2, p3.
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/game_period_lines?game_id=1'Responses
200game_period_lines rows matching the declared filter set, wrapped in { game_period_lines, 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(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 7680 | |
operator_id | bigint | Sportsbook id: 6 Consensus. e.g. 6 | |
season_id | bigint | — e.g. 2023 | |
book_count | integernullable | — | — e.g. 3 |
captured_at | timestamptz | — | — e.g. 2024-01-11T23:55:39.000Z |
draw_odds | integernullable | — | American odds for a tied period (three-way markets only) e.g. — (all-null in sample) |
implied_away_win_pct | decimalnullable | — | — e.g. 0.5 |
implied_home_win_pct | decimalnullable | — | — e.g. 0.5 |
is_opening | boolean | — | — e.g. true |
moneyline_away | integernullable | — | — e.g. 100 |
moneyline_home | integernullable | — | — e.g. -145 |
over_odds | integernullable | — | — e.g. -135 |
period_code | string | — | p1, p2 or p3 Values:p1p2p3 |
spread | decimalnullable | — | — e.g. -0.5 |
spread_away_odds | integernullable | — | — e.g. -190 |
spread_home_odds | integernullable | — | — e.g. 120 |
total | decimalnullable | — | — e.g. 1.5 |
under_odds | integernullable | — | — e.g. 105 |
GET/api/v1/nhl/game_period_lines/{id}Get a single game_period_line by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_period_line 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/game_period_lines/{pk_value}'Responses
200Single game_period_line row.application/jsonshow example ▸
404Row not found.
Response Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 7680 | |
operator_id | bigint | Sportsbook id: 6 Consensus. e.g. 6 | |
season_id | bigint | — e.g. 2023 | |
book_count | integernullable | — | — e.g. 3 |
captured_at | timestamptz | — | — e.g. 2024-01-11T23:55:39.000Z |
draw_odds | integernullable | — | American odds for a tied period (three-way markets only) e.g. — (all-null in sample) |
implied_away_win_pct | decimalnullable | — | — e.g. 0.5 |
implied_home_win_pct | decimalnullable | — | — e.g. 0.5 |
is_opening | boolean | — | — e.g. true |
moneyline_away | integernullable | — | — e.g. 100 |
moneyline_home | integernullable | — | — e.g. -145 |
over_odds | integernullable | — | — e.g. -135 |
period_code | string | — | p1, p2 or p3 Values:p1p2p3 |
spread | decimalnullable | — | — e.g. -0.5 |
spread_away_odds | integernullable | — | — e.g. -190 |
spread_home_odds | integernullable | — | — e.g. 120 |
total | decimalnullable | — | — e.g. 1.5 |
under_odds | integernullable | — | — e.g. 105 |
game_player_props
nhl.game_player_propsNHL player prop bets for each game — goals, assists, points, shots on goal, saves and other player markets, the consensus of the main sportsbooks, captured before puck drop.
GET/api/v1/nhl/game_player_propsList game_player_props for NHL
Requires one of:
game_id or player_id + season_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player. With season_id: the player's prop history across a season.
season_idquerybigintoptionalFilter by season.
categoryquerystringoptionalFilter by prop category.
market_keyquerystringoptionalFilter by market key (e.g., player_shots_on_goal).
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/game_player_props?game_id=1'Responses
200game_player_props rows matching the declared filter set, wrapped in { game_player_props, 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(18 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 20032 | |
operator_id | bigint | Usually consensus (6) e.g. 6 | |
player_id | bigint | — e.g. 321 | |
season_id | bigint | — e.g. 2026 | |
book_count | integer | — | — e.g. 1 |
captured_at | timestamptz | — | — e.g. 2026-10-01T21:20:09.654Z |
category | string | — | — Values:shots_on_goalanytime_goalgoalspointsassistssavespower_play_pointsblocked_shots |
is_opening | boolean | — | — Values:truefalse |
line | decimalnullable | — | — e.g. 1.5 |
market_key | string | — | — Values:player_goal_scorer_anyt…player_goalsplayer_shots_on_goal_al…player_shots_on_goalplayer_points_alternateplayer_goals_alternateplayer_assists_alternateplayer_pointsplayer_assistsplayer_total_saves_alte…player_power_play_point…player_total_savesplayer_blocked_shots_al…player_blocked_shots |
no_odds | integernullable | — | — e.g. — (all-null in sample) |
outcome_type | string | — | ou | yes_no Values:ouyes_no |
over_odds | integernullable | — | — e.g. 10000 |
period_code | stringnullable | — | — e.g. — (all-null in sample) |
subcategory | stringnullable | — | — e.g. alternate |
under_odds | integernullable | — | — e.g. -115 |
yes_odds | integernullable | — | — e.g. 700 |
GET/api/v1/nhl/game_player_props/{id}Get a single game_player_prop by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_player_prop 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/game_player_props/{pk_value}'Responses
200Single game_player_prop row.application/jsonshow example ▸
404Row not found.
Response Schema(18 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 20032 | |
operator_id | bigint | Usually consensus (6) e.g. 6 | |
player_id | bigint | — e.g. 321 | |
season_id | bigint | — e.g. 2026 | |
book_count | integer | — | — e.g. 1 |
captured_at | timestamptz | — | — e.g. 2026-10-01T21:20:09.654Z |
category | string | — | — Values:shots_on_goalanytime_goalgoalspointsassistssavespower_play_pointsblocked_shots |
is_opening | boolean | — | — Values:truefalse |
line | decimalnullable | — | — e.g. 1.5 |
market_key | string | — | — Values:player_goal_scorer_anyt…player_goalsplayer_shots_on_goal_al…player_shots_on_goalplayer_points_alternateplayer_goals_alternateplayer_assists_alternateplayer_pointsplayer_assistsplayer_total_saves_alte…player_power_play_point…player_total_savesplayer_blocked_shots_al…player_blocked_shots |
no_odds | integernullable | — | — e.g. — (all-null in sample) |
outcome_type | string | — | ou | yes_no Values:ouyes_no |
over_odds | integernullable | — | — e.g. 10000 |
period_code | stringnullable | — | — e.g. — (all-null in sample) |
subcategory | stringnullable | — | — e.g. alternate |
under_odds | integernullable | — | — e.g. -115 |
yes_odds | integernullable | — | — e.g. 700 |
Lineups & Roster
coaching_staffs
nhl.coaching_staffsNHL head coaches since 2021-22.
GET/api/v1/nhl/coaching_staffsList coaching_staffs for NHL
Parameters
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/coaching_staffs?limit=3'Responses
200coaching_staffs rows matching the declared filter set, wrapped in { coaching_staffs, 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(2 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
name | string | — | — e.g. Craig Berube |
GET/api/v1/nhl/coaching_staffs/{id}Get a single coaching_staff by id
Parameters
idpathbigintrequiredPrimary key (id) of the coaching_staff 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/coaching_staffs/{pk_value}'Responses
200Single coaching_staff row.application/jsonshow example ▸
404Row not found.
Response Schema(2 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
name | string | — | — e.g. Craig Berube |
line_combinations
nhl.line_combinationsNHL forward and defensive pair groupings — which players skate together as a line (first, second, third, fourth) or defensive pairing for each team.
GET/api/v1/nhl/line_combinationsList line_combinations for NHL
Requires one of:
team_id + season_id — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter by team.
season_idquerybigintoptionalFilter to a season. Defaults to the current season.
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/line_combinations?team_id=1&season_id=2026'Responses
200line_combinations rows matching the declared filter set, wrapped in { line_combinations, 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(11 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player1_id | bigint | — | — e.g. 1140 |
player2_id | bigintnullable | — | — e.g. 571 |
player3_id | bigintnullable | — | — e.g. 460 |
player4_id | bigintnullable | — | — e.g. 408 |
player5_id | bigintnullable | — | — e.g. 233 |
season_id | bigint | — e.g. 2026 | |
team_id | bigint | — e.g. 2 | |
day | date | — | — e.g. 2026-11-14 |
line_number | integer | — | — e.g. 1 |
line_type | string | — | — Values:defense_pairforward_linepower_play |
GET/api/v1/nhl/line_combinations/{id}Get a single line_combination by id
Parameters
idpathbigintrequiredPrimary key (id) of the line_combination 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/line_combinations/{pk_value}'Responses
200Single line_combination row.application/jsonshow example ▸
404Row not found.
Response Schema(11 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player1_id | bigint | — | — e.g. 1140 |
player2_id | bigintnullable | — | — e.g. 571 |
player3_id | bigintnullable | — | — e.g. 460 |
player4_id | bigintnullable | — | — e.g. 408 |
player5_id | bigintnullable | — | — e.g. 233 |
season_id | bigint | — e.g. 2026 | |
team_id | bigint | — e.g. 2 | |
day | date | — | — e.g. 2026-11-14 |
line_number | integer | — | — e.g. 1 |
line_type | string | — | — Values:defense_pairforward_linepower_play |
team_coaching_staffs
nhl.team_coaching_staffsThe head coach of each NHL team in each season since 2021-22 — the first and last game day the coach ran the bench and the number of games coached. A mid-season change gives the team two rows that season.
GET/api/v1/nhl/team_coaching_staffsList team_coaching_staffs for NHL
Requires one of:
team_id or season_id — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter by team.
season_idquerybigintoptionalFilter to a season by year (e.g., 2026 for the 2026-27 season).
coach_typequerystringoptionalFilter by coach role. Values: head_coach.
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/team_coaching_staffs?team_id=1'Responses
200team_coaching_staffs rows matching the declared filter set, wrapped in { team_coaching_staffs, 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(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
coaching_staff_id | bigint | — e.g. 3 | |
season_id | bigint | — e.g. 2021 | |
team_id | bigint | — e.g. 22 | |
coach_type | string | — | head_coach e.g. head_coach |
first_day | integer | — | YYYYMMDD date of the coach's first game with the team that season e.g. 20251009 |
games | integer | — | Games coached for the team that season e.g. 82 |
last_day | integer | — | YYYYMMDD date of the coach's last game with the team that season (so far) e.g. 20261117 |
GET/api/v1/nhl/team_coaching_staffs/{id}Get a single team_coaching_staff by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_coaching_staff 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/team_coaching_staffs/{pk_value}'Responses
200Single team_coaching_staff row.application/jsonshow example ▸
404Row not found.
Response Schema(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
coaching_staff_id | bigint | — e.g. 3 | |
season_id | bigint | — e.g. 2021 | |
team_id | bigint | — e.g. 22 | |
coach_type | string | — | head_coach e.g. head_coach |
first_day | integer | — | YYYYMMDD date of the coach's first game with the team that season e.g. 20251009 |
games | integer | — | Games coached for the team that season e.g. 82 |
last_day | integer | — | YYYYMMDD date of the coach's last game with the team that season (so far) e.g. 20261117 |
game_team_rosters
nhl.game_team_rostersThe game-day roster of each NHL game since 2021-22 — every player of each team, with the position, sweater number, whether the player dressed or was scratched, and the starting goalie.
GET/api/v1/nhl/game_team_rostersList game_team_rosters for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
player_idquerybigintoptionalFilter to a single player.
is_starting_goaliequerybooleanoptionalFilter to the starting goalies.
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/game_team_rosters?game_id=1'Responses
200game_team_rosters rows matching the declared filter set, wrapped in { game_team_rosters, 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(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3924 | |
player_id | bigint | — e.g. 7099 | |
team_id | bigint | — e.g. 25 | |
day | integer | — | YYYYMMDD date of the game e.g. 20211009 |
dressed | boolean | — | True when the player dressed for the game Values:truefalse |
is_scratched | boolean | — | True when the player was scratched (always the opposite of dressed) Values:falsetrue |
is_starting_goalie | boolean | — | True for the goalie who started the game (one per team) Values:falsetrue |
position | stringnullable | — | C, L, R, D or G Values:DCLRG |
sweater_number | integernullable | — | — e.g. 21 |
GET/api/v1/nhl/game_team_rosters/{id}Get a single game_team_roster by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_team_roster 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/game_team_rosters/{pk_value}'Responses
200Single game_team_roster row.application/jsonshow example ▸
404Row not found.
Response Schema(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3924 | |
player_id | bigint | — e.g. 7099 | |
team_id | bigint | — e.g. 25 | |
day | integer | — | YYYYMMDD date of the game e.g. 20211009 |
dressed | boolean | — | True when the player dressed for the game Values:truefalse |
is_scratched | boolean | — | True when the player was scratched (always the opposite of dressed) Values:falsetrue |
is_starting_goalie | boolean | — | True for the goalie who started the game (one per team) Values:falsetrue |
position | stringnullable | — | C, L, R, D or G Values:DCLRG |
sweater_number | integernullable | — | — e.g. 21 |
goalie_depth_charts
nhl.goalie_depth_chartsEach NHL team's goaltender depth — the starter, backup, and any third-string netminders, with the date the depth was last updated.
GET/api/v1/nhl/goalie_depth_chartsList goalie_depth_charts for NHL
Requires one of:
team_id + season_id — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter by team.
season_idquerybigintoptionalFilter to a season. Defaults to the current season.
player_idquerybigintoptionalFilter to a single goaltender.
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/goalie_depth_charts?team_id=1&season_id=2026'Responses
200goalie_depth_charts rows matching the declared filter set, wrapped in { goalie_depth_charts, 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(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 39 | |
season_id | bigint | — e.g. 2026 | |
team_id | bigint | — e.g. 2 | |
day | date | — | — e.g. 2026-11-14 |
depth_order | integer | — | 1=Starter, 2=Backup, 3=Third string e.g. 1 |
GET/api/v1/nhl/goalie_depth_charts/{id}Get a single goalie_depth_chart by id
Parameters
idpathbigintrequiredPrimary key (id) of the goalie_depth_chart 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/goalie_depth_charts/{pk_value}'Responses
200Single goalie_depth_chart row.application/jsonshow example ▸
404Row not found.
Response Schema(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 39 | |
season_id | bigint | — e.g. 2026 | |
team_id | bigint | — e.g. 2 | |
day | date | — | — e.g. 2026-11-14 |
depth_order | integer | — | 1=Starter, 2=Backup, 3=Third string e.g. 1 |
Misc
arenas
nhl.arenasNHL arenas — current home venues and historical buildings, with capacity, surface type, and ice-rink dimensions.
GET/api/v1/nhl/arenasList arenas for NHL
Parameters
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/arenas?limit=3'Responses
200arenas rows matching the declared filter set, wrapped in { arenas, 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(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_arena_id | integernullable | — | Official NHL arena ID (issued by the league) e.g. 6 |
address | stringnullable | — | — e.g. — (all-null in sample) |
capacity | integernullable | — | — e.g. — (all-null in sample) |
city | string | — | — e.g. Salt Lake City |
closed_date | timestamptznullable | — | — e.g. — (all-null in sample) |
country | stringnullable | — | — e.g. — (all-null in sample) |
description | stringnullable | — | — e.g. — (all-null in sample) |
elevation | floatnullable | — | Elevation in feet above sea level e.g. — (all-null in sample) |
image_url | stringnullable | — | URL to aerial/overview image of arena e.g. — (all-null in sample) |
latitude | floatnullable | — | — e.g. — (all-null in sample) |
longitude | floatnullable | — | — e.g. — (all-null in sample) |
name | string | — | — e.g. TD Garden |
opened_date | timestamptznullable | — | — e.g. — (all-null in sample) |
roof_type | stringnullable | — | Arena roof type (all indoor) e.g. Indoor |
state | stringnullable | — | — e.g. — (all-null in sample) |
surface | string | — | Playing surface type e.g. Ice |
team_name | stringnullable | — | — e.g. — (all-null in sample) |
timezone | stringnullable | — | IANA timezone (e.g., America/New_York) e.g. — (all-null in sample) |
GET/api/v1/nhl/arenas/{id}Get a single arena by id
Parameters
idpathbigintrequiredPrimary key (id) of the arena 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/arenas/{pk_value}'Responses
200Single arena row.application/jsonshow example ▸
404Row not found.
Response Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_arena_id | integernullable | — | Official NHL arena ID (issued by the league) e.g. 6 |
address | stringnullable | — | — e.g. — (all-null in sample) |
capacity | integernullable | — | — e.g. — (all-null in sample) |
city | string | — | — e.g. Salt Lake City |
closed_date | timestamptznullable | — | — e.g. — (all-null in sample) |
country | stringnullable | — | — e.g. — (all-null in sample) |
description | stringnullable | — | — e.g. — (all-null in sample) |
elevation | floatnullable | — | Elevation in feet above sea level e.g. — (all-null in sample) |
image_url | stringnullable | — | URL to aerial/overview image of arena e.g. — (all-null in sample) |
latitude | floatnullable | — | — e.g. — (all-null in sample) |
longitude | floatnullable | — | — e.g. — (all-null in sample) |
name | string | — | — e.g. TD Garden |
opened_date | timestamptznullable | — | — e.g. — (all-null in sample) |
roof_type | stringnullable | — | Arena roof type (all indoor) e.g. Indoor |
state | stringnullable | — | — e.g. — (all-null in sample) |
surface | string | — | Playing surface type e.g. Ice |
team_name | stringnullable | — | — e.g. — (all-null in sample) |
timezone | stringnullable | — | IANA timezone (e.g., America/New_York) e.g. — (all-null in sample) |
broadcasters
nhl.broadcastersThe TV networks and streaming services that air NHL games in the United States and Canada — national networks and team-local regional networks.
GET/api/v1/nhl/broadcastersList broadcasters for NHL
Parameters
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/broadcasters?limit=3'Responses
200broadcasters rows matching the declared filter set, wrapped in { broadcasters, 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(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
nhl_broadcaster_id | integer | — | The league's own id for this network. Not a broadcaster_id; game_broadcasters.broadcaster_id holds this table's id. e.g. 389 |
country_code | stringnullable | — | US or CA Values:USCA |
network | string | — | Network call sign (e.g. ABC, TNT, SN1, RDS, MSG) e.g. BSMW APP |
GET/api/v1/nhl/broadcasters/{id}Get a single broadcaster by id
Parameters
idpathbigintrequiredPrimary key (id) of the broadcaster 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/broadcasters/{pk_value}'Responses
200Single broadcaster row.application/jsonshow example ▸
404Row not found.
Response Schema(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
nhl_broadcaster_id | integer | — | The league's own id for this network. Not a broadcaster_id; game_broadcasters.broadcaster_id holds this table's id. e.g. 389 |
country_code | stringnullable | — | US or CA Values:USCA |
network | string | — | Network call sign (e.g. ABC, TNT, SN1, RDS, MSG) e.g. BSMW APP |
referees
nhl.refereesNHL on-ice officials — the referees and linesmen who work the games.
GET/api/v1/nhl/refereesList referees for NHL
Parameters
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/referees?limit=3'Responses
200referees rows matching the declared filter set, wrapped in { referees, 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(2 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
full_name | string | — | — e.g. Brian Pochmara |
GET/api/v1/nhl/referees/{id}Get a single referee by id
Parameters
idpathbigintrequiredPrimary key (id) of the referee 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/referees/{pk_value}'Responses
200Single referee row.application/jsonshow example ▸
404Row not found.
Response Schema(2 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
full_name | string | — | — e.g. Brian Pochmara |
playoff_series
nhl.playoff_seriesNHL Stanley Cup Playoff series — best-of-seven matchups in each round (First Round, Second Round, Conference Finals, Stanley Cup Final), with seeds, wins, and series outcomes.
GET/api/v1/nhl/playoff_seriesList playoff_series for NHL
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
home_team_idquerybigintoptionalFilter by home team.
away_team_idquerybigintoptionalFilter by away team.
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/playoff_series?season_id=2026'Responses
200playoff_series rows matching the declared filter set, wrapped in { playoff_series, 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(15 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
away_team_id | bigint | — e.g. 27 | |
home_team_id | bigint | — e.g. 9 | |
season_id | bigint | — e.g. 2021 | |
series_id | integernullable | — | — e.g. 1 |
winner_team_id | bigintnullable | — e.g. 4 | |
away_team_seed | integer | — | — e.g. 3 |
away_team_wins | integer | — | — e.g. 4 |
conference | stringnullable | — | — e.g. — (all-null in sample) |
games_played | integer | — | — e.g. 6 |
home_team_seed | integer | — | — e.g. 1 |
home_team_wins | integer | — | — e.g. 4 |
max_games | integer | — | — e.g. 7 |
playoff_round | string | — | — Values:First RoundSecond RoundConference FinalsStanley Cup Final |
status | string | — | — e.g. complete |
GET/api/v1/nhl/playoff_series/{id}Get a single playoff_sery by id
Parameters
idpathbigintrequiredPrimary key (id) of the playoff_sery 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/playoff_series/{pk_value}'Responses
200Single playoff_sery row.application/jsonshow example ▸
404Row not found.
Response Schema(15 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
away_team_id | bigint | — e.g. 27 | |
home_team_id | bigint | — e.g. 9 | |
season_id | bigint | — e.g. 2021 | |
series_id | integernullable | — | — e.g. 1 |
winner_team_id | bigintnullable | — e.g. 4 | |
away_team_seed | integer | — | — e.g. 3 |
away_team_wins | integer | — | — e.g. 4 |
conference | stringnullable | — | — e.g. — (all-null in sample) |
games_played | integer | — | — e.g. 6 |
home_team_seed | integer | — | — e.g. 1 |
home_team_wins | integer | — | — e.g. 4 |
max_games | integer | — | — e.g. 7 |
playoff_round | string | — | — Values:First RoundSecond RoundConference FinalsStanley Cup Final |
status | string | — | — e.g. complete |
game_broadcasters
nhl.game_broadcastersWhich networks aired each NHL game since 2021-22 — national carriers and the home and away teams' regional networks.
GET/api/v1/nhl/game_broadcastersList game_broadcasters for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
broadcaster_idquerybigintoptionalFilter by broadcaster.
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/game_broadcasters?game_id=1'Responses
200game_broadcasters rows matching the declared filter set, wrapped in { game_broadcasters, 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(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
broadcaster_id | bigint | — e.g. 62 | |
game_id | bigint | — e.g. 2981 | |
market | string | — | H home team's market, A away team's market, N national Values:NHA |
GET/api/v1/nhl/game_broadcasters/{id}Get a single game_broadcaster by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_broadcaster 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/game_broadcasters/{pk_value}'Responses
200Single game_broadcaster row.application/jsonshow example ▸
404Row not found.
Response Schema(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
broadcaster_id | bigint | — e.g. 62 | |
game_id | bigint | — e.g. 2981 | |
market | string | — | H home team's market, A away team's market, N national Values:NHA |
game_referees
nhl.game_refereesThe officiating crew of each NHL game since 2021-22 — two referees and two linesmen, with their sweater numbers.
GET/api/v1/nhl/game_refereesList game_referees for NHL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
referee_idquerybigintoptionalFilter by official.
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/game_referees?game_id=1'Responses
200game_referees rows matching the declared filter set, wrapped in { game_referees, 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(5 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 15253 | |
referee_id | bigint | — e.g. 32 | |
position | string | — | referee or linesman Values:refereelinesman |
sweater_number | integernullable | — | — e.g. 79 |
GET/api/v1/nhl/game_referees/{id}Get a single game_referee by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_referee 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/game_referees/{pk_value}'Responses
200Single game_referee row.application/jsonshow example ▸
404Row not found.
Response Schema(5 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 15253 | |
referee_id | bigint | — e.g. 32 | |
position | string | — | referee or linesman Values:refereelinesman |
sweater_number | integernullable | — | — e.g. 79 |
player_news
nhl.player_newsNews about NHL players — trades, IR placements, line changes, suspensions, and general beat-reporter updates.
GET/api/v1/nhl/player_newsList player_news for NHL
Requires one of:
player_id or team_id — requests satisfying none of these return 400.Parameters
player_idquerybigintoptionalFilter to a single player.
team_idquerybigintoptionalFilter by team.
categoryquerystringoptionalFilter by news category (injury, transaction, lineup, general). Values: general, injury, lineup, transaction.
status_enumquerystringoptionalFilter by player status designation. Values: RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, OUT_SEASON, TRADED, RELEASED, SIGNED, ROUTINE, UNSIGNED.
urgencyquerystringoptionalFilter by news urgency. Values: BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE.
news_timequerytimestamptzoptionalFilter by publication time (ISO 8601). Use news_time__gte to poll for items since your last check. Range syntax: news_time__gte=, news_time__lte=, news_time__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/player_news?player_id=1'Responses
200player_news rows matching the declared filter set, wrapped in { player_news, 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(21 fields)show schema ▸
27 total fields (1 nested object/array groups)
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when this news item relates to a specific game. e.g. 1930 | |
news_id | integernullable | — | External news item ID from the provider. e.g. 38315 |
opponent_team_id | bigintnullable | Opponent team ID when this news item relates to an upcoming or active game matchup. e.g. 32 | |
player_id | bigintnullable | Player ID associated with the news report. e.g. 195 | |
team_id | bigintnullable | Team ID of the player at the time of publication. e.g. 22 | |
ai_processed | boolean | — | Whether this story was generated or enriched via LLM summarization. Values:falsetrue |
author | stringnullable | — | Reporter or author of the article. e.g. — (all-null in sample) |
categories | stringnullable | — | Comma-separated raw topic tags. e.g. — (all-null in sample) |
category | stringnullable | — | injury, transaction, lineup, general Values:injurytransactiongeneralcontractlineupsuspension |
content | stringnullable | — | Full text content of the news report. e.g. Carolina Hurricanes left wing William Carrier (upper body) … |
description | stringnullable | — | Brief synopsis or summary of the news event. e.g. Edmonton defenseman Alec Regula has been placed on injured … |
first_reported_at | timestamptznullable | — | Timestamp when this story was first reported before multi-source compaction. e.g. 1970-01-01T00:00:00.000Z |
news_time | timestamptz | — | Publication timestamp of the news story. e.g. 2026-09-29T04:00:00.000Z |
priority | integer | — | Display priority score (1-10). e.g. 5 |
situational_impact | jsonbnullable | — | Structured situational impact assessment and fantasy implications for the player. e.g. {"affected_players":[]} |
↳type situational_impact.type | stringnullable | — | Impact direction: positive, negative, or neutral. |
↳impact_enum situational_impact.impact_enum | stringnullable | — | Standardized impact state (ACTIVE, CLEARED, QUESTIONABLE, etc.). |
↳reason situational_impact.reason | stringnullable | — | Narrative explaining the fantasy and playing-time impact. |
↳ripple_effect situational_impact.ripple_effect | stringnullable | — | Downstream tactical or fantasy consequences. |
↳affected_players situational_impact.affected_players | listnullable | — | Teammates whose opportunity or role is impacted. |
↳affected_player_ids situational_impact.affected_player_ids | listnullable | — | IDs of impacted teammates. |
status_enum | stringnullable | — | Standardized player status designation (RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, TRADED, RELEASED, SIGNED, ROUTINE). Values:ACTIVEROUTINERELEASEDTRADEDQUESTIONABLESIGNEDRULED_OUTIR_PLACEDPROBABLEINACTIVECLEAREDSTARTINGBENCHED |
terms_of_use | stringnullable | — | Syndication terms and attribution. e.g. — (all-null in sample) |
title | string | — | Headline of the news report. e.g. Torey Krug placed on IR with ankle injury |
updated_time | timestamptznullable | — | Timestamp when the story was last revised. e.g. — (all-null in sample) |
urgency | stringnullable | — | Urgency level of the news event (BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE). Values:ROUTINEHIGHMEDIUMBREAKING_GAME_TIME |
GET/api/v1/nhl/player_news/{id}Get a single player_new by id
Parameters
idpathbigintrequiredPrimary key (id) of the player_new 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/player_news/{pk_value}'Responses
200Single player_new row.application/jsonshow example ▸
404Row not found.
Response Schema(21 fields)show schema ▸
27 total fields (1 nested object/array groups)
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when this news item relates to a specific game. e.g. 1930 | |
news_id | integernullable | — | External news item ID from the provider. e.g. 38315 |
opponent_team_id | bigintnullable | Opponent team ID when this news item relates to an upcoming or active game matchup. e.g. 32 | |
player_id | bigintnullable | Player ID associated with the news report. e.g. 195 | |
team_id | bigintnullable | Team ID of the player at the time of publication. e.g. 22 | |
ai_processed | boolean | — | Whether this story was generated or enriched via LLM summarization. Values:falsetrue |
author | stringnullable | — | Reporter or author of the article. e.g. — (all-null in sample) |
categories | stringnullable | — | Comma-separated raw topic tags. e.g. — (all-null in sample) |
category | stringnullable | — | injury, transaction, lineup, general Values:injurytransactiongeneralcontractlineupsuspension |
content | stringnullable | — | Full text content of the news report. e.g. Carolina Hurricanes left wing William Carrier (upper body) … |
description | stringnullable | — | Brief synopsis or summary of the news event. e.g. Edmonton defenseman Alec Regula has been placed on injured … |
first_reported_at | timestamptznullable | — | Timestamp when this story was first reported before multi-source compaction. e.g. 1970-01-01T00:00:00.000Z |
news_time | timestamptz | — | Publication timestamp of the news story. e.g. 2026-09-29T04:00:00.000Z |
priority | integer | — | Display priority score (1-10). e.g. 5 |
situational_impact | jsonbnullable | — | Structured situational impact assessment and fantasy implications for the player. e.g. {"affected_players":[]} |
↳type situational_impact.type | stringnullable | — | Impact direction: positive, negative, or neutral. |
↳impact_enum situational_impact.impact_enum | stringnullable | — | Standardized impact state (ACTIVE, CLEARED, QUESTIONABLE, etc.). |
↳reason situational_impact.reason | stringnullable | — | Narrative explaining the fantasy and playing-time impact. |
↳ripple_effect situational_impact.ripple_effect | stringnullable | — | Downstream tactical or fantasy consequences. |
↳affected_players situational_impact.affected_players | listnullable | — | Teammates whose opportunity or role is impacted. |
↳affected_player_ids situational_impact.affected_player_ids | listnullable | — | IDs of impacted teammates. |
status_enum | stringnullable | — | Standardized player status designation (RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, TRADED, RELEASED, SIGNED, ROUTINE). Values:ACTIVEROUTINERELEASEDTRADEDQUESTIONABLESIGNEDRULED_OUTIR_PLACEDPROBABLEINACTIVECLEAREDSTARTINGBENCHED |
terms_of_use | stringnullable | — | Syndication terms and attribution. e.g. — (all-null in sample) |
title | string | — | Headline of the news report. e.g. Torey Krug placed on IR with ankle injury |
updated_time | timestamptznullable | — | Timestamp when the story was last revised. e.g. — (all-null in sample) |
urgency | stringnullable | — | Urgency level of the news event (BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE). Values:ROUTINEHIGHMEDIUMBREAKING_GAME_TIME |
team_game_contexts
nhl.team_game_contextsSchedule context of each NHL team in each game — game number, games left, share of the season played, rest days and back-to-backs for the team and its opponent.
GET/api/v1/nhl/team_game_contextsList team_game_contexts for NHL
Requires one of:
game_id or season_id + team_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
season_idquerybigintoptionalFilter by season.
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/team_game_contexts?game_id=1'Responses
200team_game_contexts rows matching the declared filter set, wrapped in { team_game_contexts, 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(14 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
opponent_team_id | bigint | — | — e.g. 4 |
season_id | bigint | — e.g. 2021 | |
team_id | bigint | — e.g. 4 | |
game_number | integer | — | — e.g. 1 |
games_remaining | integer | — | — e.g. 5 |
is_back_to_back | boolean | — | — Values:falsetrue |
is_home | boolean | — | — Values:falsetrue |
opponent_is_back_to_back | boolean | — | — Values:falsetrue |
opponent_rest_days | integernullable | — | — e.g. 1 |
rest_days | integernullable | — | Full days since the team's previous game (0 = back-to-back; empty for its first game) e.g. 1 |
season_pct | decimal | — | 0.0-1.0 share of the team's games of this season type played, this one included e.g. 1.0000 |
season_type | string | — | — Values:regular_seasonpostseason |
GET/api/v1/nhl/team_game_contexts/{id}Get a single team_game_context by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_game_context 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/team_game_contexts/{pk_value}'Responses
200Single team_game_context row.application/jsonshow example ▸
404Row not found.
Response Schema(14 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 3020 | |
opponent_team_id | bigint | — | — e.g. 4 |
season_id | bigint | — e.g. 2021 | |
team_id | bigint | — e.g. 4 | |
game_number | integer | — | — e.g. 1 |
games_remaining | integer | — | — e.g. 5 |
is_back_to_back | boolean | — | — Values:falsetrue |
is_home | boolean | — | — Values:falsetrue |
opponent_is_back_to_back | boolean | — | — Values:falsetrue |
opponent_rest_days | integernullable | — | — e.g. 1 |
rest_days | integernullable | — | Full days since the team's previous game (0 = back-to-back; empty for its first game) e.g. 1 |
season_pct | decimal | — | 0.0-1.0 share of the team's games of this season type played, this one included e.g. 1.0000 |
season_type | string | — | — Values:regular_seasonpostseason |
team_news
nhl.team_newsNews and updates about NHL teams — game previews, coaching changes, front-office moves, and beat reports.
GET/api/v1/nhl/team_newsList team_news for NHL
Requires one of:
team_id — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter by team.
categoryquerystringoptionalFilter by category (game_preview, coaching, transaction, general, draft, depth_chart). Values: game_preview, coaching, transaction, general, draft, depth_chart.
urgencyquerystringoptionalFilter by news urgency. Values: BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE.
news_timequerytimestamptzoptionalFilter by publication time (ISO 8601). Use news_time__gte to poll for items since your last check. Range syntax: news_time__gte=, news_time__lte=, news_time__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/team_news?team_id=1'Responses
200team_news rows matching the declared filter set, wrapped in { team_news, 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(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when news relates to a specific game. e.g. 20266 | |
opponent_team_id | bigintnullable | Opponent team ID when news relates to an upcoming or completed game matchup. e.g. 20 | |
team_id | bigint | Team ID that this news event pertains to. e.g. 25 | |
ai_processed | booleannullable | — | Whether this story was generated or enriched via LLM summarization. e.g. true |
category | stringnullable | — | game_preview, coaching, transaction, general Values:game_previewtransactiongeneralcoachingdepth_chart |
news_time | timestamptz | — | Publication timestamp of the team story. e.g. 2026-07-01T00:00:00.000Z |
summary | string | — | Concise journalistic summary of the team news event. e.g. Colorado's franchise defenseman Cale Makar has signed a $16… |
title | string | — | Headline of the team news story. e.g. Cale Makar signs $163.2M contract, sets new NHL defenseman … |
urgency | stringnullable | — | ROUTINE, MEDIUM, HIGH, BREAKING_GAME_TIME Values:ROUTINEMEDIUMHIGHBREAKING_GAME_TIME |
GET/api/v1/nhl/team_news/{id}Get a single team_new by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_new 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/team_news/{pk_value}'Responses
200Single team_new row.application/jsonshow example ▸
404Row not found.
Response Schema(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when news relates to a specific game. e.g. 20266 | |
opponent_team_id | bigintnullable | Opponent team ID when news relates to an upcoming or completed game matchup. e.g. 20 | |
team_id | bigint | Team ID that this news event pertains to. e.g. 25 | |
ai_processed | booleannullable | — | Whether this story was generated or enriched via LLM summarization. e.g. true |
category | stringnullable | — | game_preview, coaching, transaction, general Values:game_previewtransactiongeneralcoachingdepth_chart |
news_time | timestamptz | — | Publication timestamp of the team story. e.g. 2026-07-01T00:00:00.000Z |
summary | string | — | Concise journalistic summary of the team news event. e.g. Colorado's franchise defenseman Cale Makar has signed a $16… |
title | string | — | Headline of the team news story. e.g. Cale Makar signs $163.2M contract, sets new NHL defenseman … |
urgency | stringnullable | — | ROUTINE, MEDIUM, HIGH, BREAKING_GAME_TIME Values:ROUTINEMEDIUMHIGHBREAKING_GAME_TIME |