---
title: "Games"
method: POST
path: "/v1/get_games"
tags: ["Stats + aggregation"]
---

# Games

`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

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.

## Request body

- object
  - `date_from` string: Start date (YYYY-MM-DD)
  - `date_to` string: End date (YYYY-MM-DD)
  - `team` string: Team abbreviation to filter (home or away)
  - `season` string: 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
  - `limit` integer: 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 `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `games` object[], required
      - `id` string, required
      - `season` string, nullable, required
      - `gameDate` string, nullable, required
      - `startTime` string, nullable, required
      - `homeTeam` string, required
      - `awayTeam` string, required
      - `homeScore` number, nullable, required
      - `awayScore` number, nullable, required
      - `gameState` string, nullable, required
      - `gameType` string, nullable, required
      - `venue` string, nullable, required
    - `count` number, required

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/puckapi/apis/puckapi-api.md) · [All operations](https://skmtc.dev/puckapi/apis/puckapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puckapi/apis/puckapi-api/revisions/99b3e5171ab4?raw)