GET /football/matches/{match_id}/stats - The Stats API

Get match statistics

Endpoint

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

{
  "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:

{
  "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.

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