STAT-API

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

seasonsnhl.seasons
Each 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/seasons
Parameters
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(8 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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
teamsnhl.teams
The 32 NHL franchises, organized into the Eastern and Western Conferences with two divisions each (Atlantic, Metropolitan, Central, Pacific).
GET/api/v1/nhl/teams
Parameters
activequerybooleanoptional
Filter by active status (defaults to true to show only currently-active rows; pass active=false to include inactive).
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(18 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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)
gamesnhl.games
Every 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/games
Requires one of: season_id — requests satisfying none of these return 400.
Parameters
season_idquerybigintoptional
Filter to a season. Defaults to the current season.
home_team_idquerybigintoptional
Filter by home team.
away_team_idquerybigintoptional
Filter by away team.
statusquerystringoptional
Filter by game status.
dayqueryintegeroptional
Filter 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 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(35 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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)
playersnhl.players
Every 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/players
Requires one of: team_id or roster_status — requests satisfying none of these return 400.
Parameters
team_idquerybigintoptional
Filter to players whose current team_id matches. Null team_id rows (free agents, retired) are excluded when this filter is applied.
roster_statusquerystringoptional
Filter 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 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(35 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_shiftsnhl.game_shifts
Every 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_shifts
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
player_idquerybigintoptional
Filter to a single player.
periodqueryintegeroptional
Filter to a period (1-3; 4 and up for overtime).
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(11 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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
penaltiesnhl.penalties
Every 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/penalties
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by penalized team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(12 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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
periodsnhl.periods
Per-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/periods
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(8 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_playsnhl.play_by_plays
Every 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_plays
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
period_numberqueryintegeroptional
Filter to a period (1-3; 4 and up for overtime or the shootout).
type_desc_keyquerystringoptional
Filter 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_idquerybigintoptional
Filter to the events of one team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(39 fields)show schema ▸
FieldTypeReferencesDescription
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
bigintnullablePlayer who took the penalty
e.g. 834
drawn_by_player_id
bigintnullablePlayer 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
bigintnullableTeam credited with the event
e.g. 29
game_id
bigint—
e.g. 15003
goalie_in_net_id
bigintnullableGoaltender 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
bigintnullableFaceoff loser
e.g. 6627
player_id
bigintnullablePlayer of a giveaway or takeaway
e.g. 105
scoring_player_id
bigintnullable—
e.g. 858
served_by_player_id
bigintnullablePlayer who served the penalty (bench and goalie penalties)
e.g. 7393
shooting_player_id
bigintnullable—
e.g. 6757
winning_player_id
bigintnullableFaceoff 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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
bigintnullablePlayer who took the penalty
e.g. 834
drawn_by_player_id
bigintnullablePlayer 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
bigintnullableTeam credited with the event
e.g. 29
game_id
bigint—
e.g. 15003
goalie_in_net_id
bigintnullableGoaltender 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
bigintnullableFaceoff loser
e.g. 6627
player_id
bigintnullablePlayer of a giveaway or takeaway
e.g. 105
scoring_player_id
bigintnullable—
e.g. 858
served_by_player_id
bigintnullablePlayer who served the penalty (bench and goalie penalties)
e.g. 7393
shooting_player_id
bigintnullable—
e.g. 6757
winning_player_id
bigintnullableFaceoff 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_playsnhl.scoring_plays
Every 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_plays
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by scoring team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(13 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_lookupsnhl.operator_team_lookups
How 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_lookups
Requires one of: operator_id — requests satisfying none of these return 400.
Parameters
operator_idquerybigintoptional
Filter by operator.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(6 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
operator_id
bigintOperator 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
bigintInternal 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
operator_id
bigintOperator 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
bigintInternal 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_statsnhl.season_team_stats
Season 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_stats
Requires one of: season_id — requests satisfying none of these return 400.
Parameters
season_idquerybigintoptional
Filter to a single season. Defaults to the current season.
team_idquerybigintoptional
Filter by team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(36 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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
standingsnhl.standings
Current 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/standings
Requires one of: season_id — requests satisfying none of these return 400.
Parameters
season_idquerybigintoptional
Filter to a single season. Defaults to the current season.
team_idquerybigintoptional
Filter by team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(36 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_standingsnhl.team_standings
Each 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_standings
Requires one of: season_id — requests satisfying none of these return 400.
Parameters
season_idquerybigintoptional
Filter to a single season. Defaults to the current season.
team_idquerybigintoptional
Filter by team.
dayqueryintegeroptional
Standings entering this day (YYYYMMDD integer). Range syntax: day__gte=, day__lte=, day__between=.
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(25 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_statsnhl.game_player_stats
Each 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_stats
Requires one of: game_id or player_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(67 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_statsnhl.game_team_stats
Each 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_stats
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(30 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_statsnhl.operator_game_fantasy_stats
Game-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_stats
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
operator_idquerybigintoptional
Filter by operator.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(65 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_statsnhl.operator_player_fantasy_stats
Each 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_stats
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
operator_idquerybigintoptional
Filter by operator.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(25 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_lookupsnhl.operator_player_lookups
How 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_lookups
Requires one of: operator_id — requests satisfying none of these return 400.
Parameters
operator_idquerybigintoptional
Filter by operator.
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(9 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
operator_id
bigintOperator 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
bigintnullableInternal 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
operator_id
bigintOperator 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
bigintnullableInternal 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_statsnhl.operator_team_fantasy_stats
Each NHL team's fantasy point total for each game under each fantasy operator's scoring rules.
GET/api/v1/nhl/operator_team_fantasy_stats
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
operator_idquerybigintoptional
Filter by operator.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(26 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_statsnhl.season_player_stats
Season 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_stats
Requires one of: season_id or player_id — requests satisfying none of these return 400.
Parameters
season_idquerybigintoptional
Filter to a single season. Defaults to the current season.
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(62 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_statsnhl.projected_player_stats
Our 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_stats
Requires one of: game_id or player_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
projection_idquerybigintoptional
Filter by engine version (one id per version of our NHL engine).
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(43 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_statsnhl.projected_team_stats
Our 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_stats
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
projection_idquerybigintoptional
Filter by engine version (one id per version of our NHL engine).
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 1000.
from_idquerybigintoptional
Return 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/json
Response Schema(29 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 19958
opponent_team_id
bigintThe 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 19958
opponent_team_id
bigintThe 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_linesnhl.game_lines
NHL 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_lines
Requires one of: game_id or season_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
season_idquerybigintoptional
Filter by season.
is_openingquerybooleanoptional
Filter to opening lines only.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(19 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 20339
operator_id
bigintSportsbook id: 6 Consensus.
e.g. 6
season_id
bigintDenormalized 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 20339
operator_id
bigintSportsbook id: 6 Consensus.
e.g. 6
season_id
bigintDenormalized 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_linesnhl.game_period_lines
NHL 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_lines
Requires one of: game_id or season_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
season_idquerybigintoptional
Filter by season.
period_codequerystringoptional
Filter by period: p1, p2 or p3. Values: p1, p2, p3.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(19 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 7680
operator_id
bigintSportsbook 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 7680
operator_id
bigintSportsbook 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_propsnhl.game_player_props
NHL 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_props
Requires one of: game_id or player_id + season_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player. With season_id: the player's prop history across a season.
season_idquerybigintoptional
Filter by season.
categoryquerystringoptional
Filter by prop category.
market_keyquerystringoptional
Filter by market key (e.g., player_shots_on_goal).
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(18 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 20032
operator_id
bigintUsually 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 20032
operator_id
bigintUsually 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_staffsnhl.coaching_staffs
NHL head coaches since 2021-22.
GET/api/v1/nhl/coaching_staffs
Parameters
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(2 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
name
string——
e.g. Craig Berube
GET/api/v1/nhl/coaching_staffs/{id}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
name
string——
e.g. Craig Berube
line_combinationsnhl.line_combinations
NHL 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_combinations
Requires one of: team_id + season_id — requests satisfying none of these return 400.
Parameters
team_idquerybigintoptional
Filter by team.
season_idquerybigintoptional
Filter to a season. Defaults to the current season.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(11 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_staffsnhl.team_coaching_staffs
The 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_staffs
Requires one of: team_id or season_id — requests satisfying none of these return 400.
Parameters
team_idquerybigintoptional
Filter by team.
season_idquerybigintoptional
Filter to a season by year (e.g., 2026 for the 2026-27 season).
coach_typequerystringoptional
Filter by coach role. Values: head_coach.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(8 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_rostersnhl.game_team_rosters
The 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_rosters
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
player_idquerybigintoptional
Filter to a single player.
is_starting_goaliequerybooleanoptional
Filter to the starting goalies.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(10 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_chartsnhl.goalie_depth_charts
Each 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_charts
Requires one of: team_id + season_id — requests satisfying none of these return 400.
Parameters
team_idquerybigintoptional
Filter by team.
season_idquerybigintoptional
Filter to a season. Defaults to the current season.
player_idquerybigintoptional
Filter to a single goaltender.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(6 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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

arenasnhl.arenas
NHL arenas — current home venues and historical buildings, with capacity, surface type, and ice-rink dimensions.
GET/api/v1/nhl/arenas
Parameters
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(19 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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)
broadcastersnhl.broadcasters
The 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/broadcasters
Parameters
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(4 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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
refereesnhl.referees
NHL on-ice officials — the referees and linesmen who work the games.
GET/api/v1/nhl/referees
Parameters
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(2 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
full_name
string——
e.g. Brian Pochmara
GET/api/v1/nhl/referees/{id}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
full_name
string——
e.g. Brian Pochmara
playoff_seriesnhl.playoff_series
NHL 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_series
Requires one of: season_id — requests satisfying none of these return 400.
Parameters
season_idquerybigintoptional
Filter to a single season. Defaults to the current season.
home_team_idquerybigintoptional
Filter by home team.
away_team_idquerybigintoptional
Filter by away team.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(15 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_broadcastersnhl.game_broadcasters
Which networks aired each NHL game since 2021-22 — national carriers and the home and away teams' regional networks.
GET/api/v1/nhl/game_broadcasters
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
broadcaster_idquerybigintoptional
Filter by broadcaster.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(4 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_refereesnhl.game_referees
The officiating crew of each NHL game since 2021-22 — two referees and two linesmen, with their sweater numbers.
GET/api/v1/nhl/game_referees
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
referee_idquerybigintoptional
Filter by official.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(5 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_newsnhl.player_news
News about NHL players — trades, IR placements, line changes, suspensions, and general beat-reporter updates.
GET/api/v1/nhl/player_news
Requires one of: player_id or team_id — requests satisfying none of these return 400.
Parameters
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
categoryquerystringoptional
Filter by news category (injury, transaction, lineup, general). Values: general, injury, lineup, transaction.
status_enumquerystringoptional
Filter 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.
urgencyquerystringoptional
Filter by news urgency. Values: BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE.
news_timequerytimestamptzoptional
Filter 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 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(21 fields)show schema ▸
27 total fields (1 nested object/array groups)
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigintnullableAssociated 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
bigintnullableOpponent team ID when this news item relates to an upcoming or active game matchup.
e.g. 32
player_id
bigintnullablePlayer ID associated with the news report.
e.g. 195
team_id
bigintnullableTeam 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}
Parameters
idpathbigintrequired
Primary 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)
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigintnullableAssociated 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
bigintnullableOpponent team ID when this news item relates to an upcoming or active game matchup.
e.g. 32
player_id
bigintnullablePlayer ID associated with the news report.
e.g. 195
team_id
bigintnullableTeam 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_contextsnhl.team_game_contexts
Schedule 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_contexts
Requires one of: game_id or season_id + team_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
season_idquerybigintoptional
Filter by season.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(14 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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_newsnhl.team_news
News and updates about NHL teams — game previews, coaching changes, front-office moves, and beat reports.
GET/api/v1/nhl/team_news
Requires one of: team_id — requests satisfying none of these return 400.
Parameters
team_idquerybigintoptional
Filter by team.
categoryquerystringoptional
Filter by category (game_preview, coaching, transaction, general, draft, depth_chart). Values: game_preview, coaching, transaction, general, draft, depth_chart.
urgencyquerystringoptional
Filter by news urgency. Values: BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE.
news_timequerytimestamptzoptional
Filter 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 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(10 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigintnullableAssociated game ID when news relates to a specific game.
e.g. 20266
opponent_team_id
bigintnullableOpponent team ID when news relates to an upcoming or completed game matchup.
e.g. 20
team_id
bigintTeam 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigintnullableAssociated game ID when news relates to a specific game.
e.g. 20266
opponent_team_id
bigintnullableOpponent team ID when news relates to an upcoming or completed game matchup.
e.g. 20
team_id
bigintTeam 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