Stats + aggregation

Games

Use when querying past or future games with filters. Returns scores, teams, venue, and game metadata. For upcoming-only games, prefer get_schedule (2 cr) instead. Costs 5 credits.

post/v1/get_games

Request

  • Base URL: https://mcp.puckapi.com
  • URL: https://mcp.puckapi.com/v1/get_games
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

date_fromstring

Start date (YYYY-MM-DD)

date_tostring

End date (YYYY-MM-DD)

teamstring

Team abbreviation to filter (home or away)

seasonstring

Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted.

game_state'FUT' | 'LIVE' | 'FINAL' | 'OFF'

Filter by game state. FINAL and OFF both mean finished and return the same games; FUT is scheduled, LIVE in progress.

game_type'regular' | 'playoff' | 'preseason'

Filter by game type

limitinteger

Max results (default 100)

league'nhl' | 'pwhl' | 'ohl' | 'whl' | 'qmjhl' | 'echl' | 'ahl' | 'ushl'

League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.

Response

The result, wrapped in data.

Changes

No recorded changes to this operation across all 1 revision of this API.