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.)

Full field reference (8 columns) → Data Dictionary Query in GraphQL →

⚠️ This endpoint is documented but not yet live. Calls return 503 until data is wired in.

GET/api/v1/nhl/periodsList periods for NHL

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 }. 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(8 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
game_id	bigint		— e.g. — (all-null in sample)
league_game_id	integer	—	Official NHL game ID (issued by the league; matches nhl.games.league_game_id). e.g. — (all-null in sample)
period_id	integer	—	— e.g. — (all-null in sample)
away_team_score	integer	—	— e.g. — (all-null in sample)
home_team_score	integer	—	— e.g. — (all-null in sample)
name	string	—	1, 2, 3, OT, OT2, SO e.g. — (all-null in sample)
period_number	integer	—	— e.g. — (all-null in sample)

GET/api/v1/nhl/periods/{id}Get a single period by 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.

503Coming soon — handler returns 503 until data is wired in.

Response Schema(8 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
game_id	bigint		— e.g. — (all-null in sample)
league_game_id	integer	—	Official NHL game ID (issued by the league; matches nhl.games.league_game_id). e.g. — (all-null in sample)
period_id	integer	—	— e.g. — (all-null in sample)
away_team_score	integer	—	— e.g. — (all-null in sample)
home_team_score	integer	—	— e.g. — (all-null in sample)
name	string	—	1, 2, 3, OT, OT2, SO e.g. — (all-null in sample)
period_number	integer	—	— e.g. — (all-null in sample)