> ## 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}/stats

> Retrieve aggregated team statistics for a match, grouped by overview, shots, attack, passes, duels, defending, goalkeeping, and xG.

Get match statistics

## Endpoint

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

Returns team-level match statistics split by full match, first half, and second half. Most stat fields share the same value shape.

## Path parameters

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

## Response shape

```json theme={null}
{
  "data": {
    "match_id": "mt_838955483",
    "overview": {
      "ball_possession": {
        "all": { "home": 54, "away": 46 },
        "first_half": { "home": 52, "away": 48 },
        "second_half": { "home": 56, "away": 44 }
      }
    },
    "shots": {},
    "attack": {},
    "passes": {},
    "duels": {},
    "defending": {},
    "goalkeeping": {},
    "np_expected_goals": {
      "all": { "home": 1.45, "away": 0.82 },
      "first_half": { "home": 0.72, "away": 0.30 },
      "second_half": { "home": 0.73, "away": 0.52 }
    }
  }
}
```

## Shared stat value format

Each stat item usually has this shape:

```json theme={null}
{
  "all": { "home": 10, "away": 8 },
  "first_half": { "home": 4, "away": 3 },
  "second_half": { "home": 6, "away": 5 }
}
```

## Stat categories

| Category            | Fields                                                                                                                                                                                                               |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `overview`          | `ball_possession`, `expected_goals`, `big_chances`, `total_shots`, `shots_on_target`, `goalkeeper_saves`, `corner_kicks`, `fouls`, `yellow_cards`, `red_cards`, `passes`, `accurate_passes`, `tackles`, `free_kicks` |
| `shots`             | `total_shots`, `shots_on_target`, `shots_off_target`, `blocked_shots`, `shots_inside_box`, `shots_outside_box`, `hit_woodwork`                                                                                       |
| `attack`            | `big_chances_missed`, `touches_in_penalty_area`, `fouled_in_final_third`, `offsides`                                                                                                                                 |
| `passes`            | `accurate_passes`, `throw_ins`, `accurate_crosses`, `accurate_long_balls`, `final_third_entries`                                                                                                                     |
| `duels`             | `duels_won_percentage`, `dispossessed`, `dribbles_percentage`, `ground_duels_percentage`, `aerial_duels_percentage`                                                                                                  |
| `defending`         | `tackles`, `tackles_won_percentage`, `interceptions`, `clearances`, `ball_recoveries`                                                                                                                                |
| `goalkeeping`       | `saves`, `goal_kicks`, `goals_prevented`, `high_claims`                                                                                                                                                              |
| `np_expected_goals` | Non-penalty expected goals totals using the shared period/team shape.                                                                                                                                                |

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