---
title: "Shot map"
method: POST
path: "/v1/get_shot_map"
tags: ["Multi-table"]
---

# Shot map

`POST /v1/get_shot_map`

## Request

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

Use when you want shot locations rather than a list of events: every shot attempt with rink coordinates, shot type, strength, shooter and goalie. Filter by game, or by season plus a team or player. Paginated: follow next_offset, since a season runs past one page and pages are chronological. Costs 10 credits.

## Request body

- object
  - `game_id` string: NHL game ID
  - `season` string: Season ID, 8-digit (e.g. 20242025); use with team
  - `team` string: Team abbreviation; use with season
  - `player_id` integer: NHL player ID of the shooter
  - `strength` string: Strength filter, e.g. 5v5
  - `limit` integer: Max shots per page (default 1000)
  - `offset` integer: Pagination offset; follow next_offset for a full season
  - `league` 'nhl' | 'pwhl' | 'ohl' | 'qmjhl' | 'echl' | 'ahl': League. Defaults to nhl. One of: nhl, pwhl, ohl, qmjhl, echl, ahl.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `shots` object[], required
    - `summary` object, required
    - `count` number, required
    - `next_offset` number, nullable, 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)