> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportrix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /matches/{id}/live — Fetch Live Score Snapshot

> GET /matches/{id}/live returns the freshest in-play score, clock, statistics, and events for a match. Requires live_scores or live_scores_statistics scope.

`GET /matches/{match_id}/live` returns the most up-to-date snapshot of a match in progress — including the current score, match clock, phase, statistics, and event timeline. It is the REST equivalent of the real-time WebSocket stream, giving you an on-demand point-in-time pull of live match state.

## Endpoint

```
GET https://api.sportrixdata.com/api/matches/{match_id}/live
```

## Authentication and Scope

Requires either the `live_scores` **or** `live_scores_statistics` scope. Either scope is sufficient to call this endpoint. Include your API key in the `X-API-Key` header.

## Path Parameter

<ParamField path="match_id" type="integer" required>
  The match id. Obtain this from any [`GET /matches`](/api/matches) response.
</ParamField>

## Response

Returns a [live snapshot object](/api/live-snapshot) representing the current state of the match. The snapshot includes the score, clock, phase, statistics, and event timeline.

## Availability and Fallback

The endpoint serves the freshest available snapshot for the match. If the real-time state is temporarily unavailable, it falls back to the last persisted snapshot automatically — you do not need to handle this yourself.

<Note>
  This means the endpoint remains usable through brief connectivity gaps between the API and its upstream data provider. It also returns the final match state after a match ends, so you can retrieve the last known snapshot even after full-time.
</Note>

A `404` is returned only when no snapshot has ever been recorded for the match — for example, if the match was never picked up by the live scoring system.

## Example Request

```bash theme={null}
curl "https://api.sportrixdata.com/api/matches/41282/live" \
  -H "X-API-Key: $KEY"
```