---
title: "List season_player_stats for NHL"
method: GET
path: "/api/v1/nhl/season_player_stats"
tags: ["NHL"]
---

# List season_player_stats for NHL

`GET /api/v1/nhl/season_player_stats`

## Request

- Base URL: `https://api.stat-api.com`
- URL: `https://api.stat-api.com/api/v1/nhl/season_player_stats`
- Auth: HTTP bearer

⚠️ This endpoint is documented but not yet live. Calls return 503 until the NHL data load is in production.

## Query parameters

- `season_id` integer
- `player_id` integer
- `team_id` integer
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

season_player_stats rows matching the declared filter set.

- NHLSeasonPlayerStatsListResponse
  - `has_more` boolean, required: True when a full page came back, so more rows can exist.
  - `limit` integer, required: Page size used for this response.
  - `next_from_id` integer, nullable, required: Pass this as `from_id` on the next request to page forward. `null` on the terminal page, and on a first page requested without `from_id` (that page uses the default sort): to walk every row, start with `from_id=0`.
  - `season_player_stats` NHLSeasonPlayerStats[], required
    - `assists` integer, required
    - `assists_per_game` number, double, required
    - `blocked_shots` integer, required
    - `empty_net_goals` integer, required
    - `even_strength_assists` integer, required
    - `even_strength_goals` integer, required
    - `even_strength_time_on_ice_seconds` integer, required
    - `faceoff_percentage` number, double, required
    - `faceoffs_lost` integer, required
    - `faceoffs_won` integer, required
    - `game_winning_goals` integer, required
    - `games_played` integer, required
    - `games_started` integer, required
    - `giveaways` integer, required
    - `goals` integer, required
    - `goals_against` integer, required
    - `goals_against_average` number, double, required
    - `goals_per_game` number, double, required
    - `hat_tricks` integer, required
    - `hits` integer, required
    - `id` integer, required: Primary Key
    - `losses` integer, required
    - `major_penalties` integer, required
    - `minor_penalties` integer, required
    - `minutes_played` integer, required
    - `overtime_goals` integer, required
    - `overtime_losses` integer, required
    - `penalties` integer, required
    - `penalty_minutes` integer, required
    - `player_id` integer, required
    - `plus_minus` integer, required
    - `position` string, nullable
    - `power_play_assists` integer, required
    - `power_play_goals` integer, required
    - `power_play_pts` integer, required
    - `power_play_time_on_ice_seconds` integer, required
    - `pts` integer, required
    - `pts_per_game` number, double, required
    - `save_percentage` number, double, required
    - `saves` integer, required
    - `season_id` integer, required
    - `season_type` string, required: Canonical season phase (text). Was integer 1/2/3 before the 2026-06-29 normalization.
    - `shifts` integer, required
    - `shooting_percentage` number, double, required
    - `shootout_attempts` integer, required
    - `shootout_goals` integer, required
    - `shootout_goals_against` integer, required
    - `shootout_misses` integer, required
    - `shootout_saves` integer, required
    - `short_handed_assists` integer, required
    - `short_handed_goals` integer, required
    - `short_handed_pts` integer, required
    - `short_handed_time_on_ice_seconds` integer, required
    - `shots` integer, required
    - `shots_against` integer, required
    - `shots_on_goal` integer, required
    - `shutouts` integer, required
    - `takeaways` integer, required
    - `team_id` integer, nullable
    - `time_on_ice_per_game` number, double, required
    - `time_on_ice_seconds` integer, required
    - `wins` integer, required

## Other responses

- `400`: No declared filter set was satisfied by the request — see `accepted` in the body for the valid combinations.
- `503`: Coming soon — handler returns 503 until data is wired in.

---

[API](https://skmtc.dev/stat-api/apis/sports-db-public-api.md) · [All operations](https://skmtc.dev/stat-api/apis/sports-db-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stat-api/apis/sports-db-public-api/revisions/23b66b957723?raw)