> ## Documentation Index
> Fetch the complete documentation index at: https://www.thestatsapi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /football/matches/{match_id}/shotmap

> Retrieve every shot in a match with xG, coordinates, body part, situation, derived flags, and non-penalty xG summary.

Get match shotmap

## Endpoint

```text theme={null}
GET https://api.thestatsapi.com/api/football/matches/{match_id}/shotmap
```

Retrieve every shot taken in a match, along with per-shot metadata including xG, body part, situation, coordinates, derived flags, and non-penalty xG summaries.

## Path parameters

| Name       | Type   | Required | Description             |
| ---------- | ------ | -------- | ----------------------- |
| `match_id` | string | Yes      | Example: `mt_838955483` |

## Query parameters

| Name        | Type   | Required | Default | Description                                                     |
| ----------- | ------ | -------- | ------- | --------------------------------------------------------------- |
| `player_id` | string | No       |         | Filter the shot list to a single player. Example: `pl_29627593` |

## Response (200)

```json theme={null}
{
  "match_id": "mt_838955483",
  "event": {
    "id": "mt_838955483",
    "home_team_id": "tm_0406",
    "away_team_id": "tm_1002"
  },
  "data": [
    {
      "id": "sh_4812",
      "player_id": "pl_29627593",
      "player_name": "Mohamed Salah",
      "team_id": "tm_0406",
      "team_name": "Liverpool",
      "x": 62.1,
      "y": 88.3,
      "minute": 24,
      "result": "goal",
      "expected_goals": 0.47,
      "situation": "regular",
      "body_part": "right-foot",
      "goal_type": "regular",
      "goal_mouth_location": "high-left",
      "goal_mouth_coordinates": {
        "x": 1.2,
        "y": 0.8,
        "z": 0.4
      },
      "block_coordinates": null,
      "is_blocked_shot": false,
      "blocked_by_player_id": "pl_08984824",
      "goalkeeper": {
        "id": "pl_29627593",
        "name": "Manuel Neuer"
      },
      "is_goal": true,
      "is_on_target": true,
      "is_headed": false,
      "is_outside_box": false,
      "is_penalty": false
    }
  ],
  "np_xg_summary": {
    "live": {
      "home_team": 1.45,
      "away_team": 0.82
    },
    "stored": {
      "home_team": 1.45,
      "away_team": 0.82
    }
  }
}
```

<Note>
  This page is generated from the live API contract at `https://api.thestatsapi.com/llms.txt`.
</Note>