Skip to main content
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

​
match_id
integer
required
The match id. Obtain this from any GET /matches response.

​
Response

Returns a live snapshot object 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.
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.
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

curl "https://api.sportrixdata.com/api/matches/41282/live" \
  -H "X-API-Key: $KEY"