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

Return live in-match statistics for a single match.

Endpoint

GET https://api.thestatsapi.com/api/football/matches/{match_id}/live-stats

Path parameters

Name	Type	Required	Description
`match_id`	string	Yes	Match ID. Example: `mt_838955483`

Response

{
  "data": {
    "match_id": "mt_838955483",
    "meta": {
      "match_status": "second_half",
      "elapsed_minutes": 67,
      "home_goals": 0,
      "away_goals": 0,
      "ht_score": null,
      "period": "second_half"
    },
    "stats": {
      "ball_possession": {
        "all": { "home": 48, "away": 52 }
      },
      "total_shots": {
        "all": { "home": 7, "away": 9 }
      },
      "corner_kicks": {
        "all": { "home": 4, "away": 5 }
      }
    }
  }
}

Live stats are only available for matches with live coverage. Use GET /football/matches or GET /football/matches/{match_id} to inspect match status and coverage flags.