> ## 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}/players/{player_id}/heatmap

> Return 0-100 pitch-coordinate heatmap points for one player in one match.

Return heatmap points for one player's touches in one match.

## Endpoint

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

Each point uses `x` and `y` integer pitch coordinates from 0 to 100. Points are returned in capture order.

## Path parameters

| Name        | Type   | Required | Description                       |
| ----------- | ------ | -------- | --------------------------------- |
| `match_id`  | string | Yes      | Match ID. Example: `mt_404012971` |
| `player_id` | string | Yes      | Player ID. Example: `pl_84027040` |

## Response

```json theme={null}
{
  "data": {
    "match_id": "mt_404012971",
    "player": {
      "id": "pl_84027040",
      "name": "Dusan Vlahovic"
    },
    "team": {
      "id": "tm_5025",
      "name": "Juventus",
      "side": "home"
    },
    "points": [
      { "x": 41, "y": 9 },
      { "x": 44, "y": 12 }
    ]
  }
}
```

<Note>
  The endpoint returns `404` when no heatmap is available, for example for an unused substitute or a fixture without movement coverage.
</Note>