STAT-API

NHL season_team_stats API

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.
Full field reference (36 columns) → Data DictionaryQuery in GraphQL →
⚠️ This endpoint is documented but not yet live. Calls return 503 until data is wired in.
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 }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.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
503Coming soon — handler returns 503 until data is wired in.
Response Schema(36 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
season_id
bigint—
e.g. — (all-null in sample)
team_id
bigint—
e.g. — (all-null in sample)
blocked_shots
integer——
e.g. — (all-null in sample)
faceoff_losses
integer——
e.g. — (all-null in sample)
faceoff_percentage
decimal——
e.g. — (all-null in sample)
faceoff_wins
integer——
e.g. — (all-null in sample)
games_played
integer——
e.g. — (all-null in sample)
giveaways
integer——
e.g. — (all-null in sample)
goal_differential
integer——
e.g. — (all-null in sample)
goals_against
integer——
e.g. — (all-null in sample)
goals_against_average
decimal——
e.g. — (all-null in sample)
goals_against_per_game
decimal——
e.g. — (all-null in sample)
goals_for
integer——
e.g. — (all-null in sample)
goals_per_game
decimal——
e.g. — (all-null in sample)
hits
integer——
e.g. — (all-null in sample)
losses
integer——
e.g. — (all-null in sample)
overtime_losses
integer——
e.g. — (all-null in sample)
penalty_kill_goals_against
integer——
e.g. — (all-null in sample)
penalty_kill_percentage
decimal——
e.g. — (all-null in sample)
penalty_minutes
integer——
e.g. — (all-null in sample)
power_play_goals
integer——
e.g. — (all-null in sample)
power_play_opportunities
integer——
e.g. — (all-null in sample)
power_play_percentage
decimal——
e.g. — (all-null in sample)
pts
integer——
e.g. — (all-null in sample)
pts_percentage
decimal——
e.g. — (all-null in sample)
save_percentage
decimal——
e.g. — (all-null in sample)
season_type
string—Canonical season phase (text). Was integer 1/2/3 before the 2026-06-29 normalization.
e.g. — (all-null in sample)
shooting_percentage
decimal——
e.g. — (all-null in sample)
short_handed_goals
integer——
e.g. — (all-null in sample)
shots_against
integer——
e.g. — (all-null in sample)
shots_for
integer——
e.g. — (all-null in sample)
shutouts
integer——
e.g. — (all-null in sample)
takeaways
integer——
e.g. — (all-null in sample)
times_shorthanded
integer——
e.g. — (all-null in sample)
wins
integer——
e.g. — (all-null in sample)
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.
503Coming soon — handler returns 503 until data is wired in.
Response Schema(36 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
season_id
bigint—
e.g. — (all-null in sample)
team_id
bigint—
e.g. — (all-null in sample)
blocked_shots
integer——
e.g. — (all-null in sample)
faceoff_losses
integer——
e.g. — (all-null in sample)
faceoff_percentage
decimal——
e.g. — (all-null in sample)
faceoff_wins
integer——
e.g. — (all-null in sample)
games_played
integer——
e.g. — (all-null in sample)
giveaways
integer——
e.g. — (all-null in sample)
goal_differential
integer——
e.g. — (all-null in sample)
goals_against
integer——
e.g. — (all-null in sample)
goals_against_average
decimal——
e.g. — (all-null in sample)
goals_against_per_game
decimal——
e.g. — (all-null in sample)
goals_for
integer——
e.g. — (all-null in sample)
goals_per_game
decimal——
e.g. — (all-null in sample)
hits
integer——
e.g. — (all-null in sample)
losses
integer——
e.g. — (all-null in sample)
overtime_losses
integer——
e.g. — (all-null in sample)
penalty_kill_goals_against
integer——
e.g. — (all-null in sample)
penalty_kill_percentage
decimal——
e.g. — (all-null in sample)
penalty_minutes
integer——
e.g. — (all-null in sample)
power_play_goals
integer——
e.g. — (all-null in sample)
power_play_opportunities
integer——
e.g. — (all-null in sample)
power_play_percentage
decimal——
e.g. — (all-null in sample)
pts
integer——
e.g. — (all-null in sample)
pts_percentage
decimal——
e.g. — (all-null in sample)
save_percentage
decimal——
e.g. — (all-null in sample)
season_type
string—Canonical season phase (text). Was integer 1/2/3 before the 2026-06-29 normalization.
e.g. — (all-null in sample)
shooting_percentage
decimal——
e.g. — (all-null in sample)
short_handed_goals
integer——
e.g. — (all-null in sample)
shots_against
integer——
e.g. — (all-null in sample)
shots_for
integer——
e.g. — (all-null in sample)
shutouts
integer——
e.g. — (all-null in sample)
takeaways
integer——
e.g. — (all-null in sample)
times_shorthanded
integer——
e.g. — (all-null in sample)
wins
integer——
e.g. — (all-null in sample)