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

> Return in-progress match statistics and live score metadata.

Return live in-match statistics for a single match.

## Endpoint

```text theme={null}
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

```json theme={null}
{
  "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 }
      }
    }
  }
}
```

<Note>
  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.
</Note>