# Sportrix Data

## Docs

- [Match Events, Statistics, and Ball Position Reference](https://docs.sportrixdata.com/api/events-stats.md): Reference for the events timeline, statistics map, and ball position in Sportrix Data live snapshots. Covers event types and common soccer stat keys.
- [GET /health — Liveness Check for Sportrix Data API](https://docs.sportrixdata.com/api/health.md): GET /health returns a simple status check for the Sportrix Data API. No authentication required — use it to verify the service is reachable.
- [GET /leagues — List All Leagues and Active Leagues](https://docs.sportrixdata.com/api/leagues.md): GET /leagues and GET /leagues/active return paginated lists of leagues for a given sport. Requires the fixtures scope and a sport query parameter.
- [GET /matches/{id}/live — Fetch Live Score Snapshot](https://docs.sportrixdata.com/api/live.md): 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.
- [Sportrix Data Live Snapshot Object — Schema Reference](https://docs.sportrixdata.com/api/live-snapshot.md): The live snapshot object is returned by GET /live, GET /result, and WebSocket frames. It contains score, clock, phase, statistics, and events.
- [Sportrix Data Match Object — REST API Schema Reference](https://docs.sportrixdata.com/api/match-object.md): The Match object is returned by /matches, /matches/active, and /matches/{id}. It contains match id, team names, start time, and current status.
- [GET /matches — List and Filter Matches by League](https://docs.sportrixdata.com/api/matches.md): GET /matches and GET /matches/active return paginated match lists. Filter by status, date range, and more. Requires the fixtures scope.
- [Sportrix Data REST API — Overview and Authentication](https://docs.sportrixdata.com/api/overview.md): An overview of the Sportrix Data REST API: base URL, authentication, response conventions, date formats, and status codes used across all endpoints.
- [GET /matches/{id}/result — Half-Time and Full-Time Results](https://docs.sportrixdata.com/api/result.md): GET /matches/{id}/result returns frozen half-time and full-time snapshots for a match, including the full event timeline. Requires the final_scores scope.
- [GET /sports — List Enabled Sports for Your Account](https://docs.sportrixdata.com/api/sports.md): GET /sports lists the sports your API key is authorized to access. Returns an array of sport objects with id and name. Requires the fixtures scope.
- [WebSocket Message Reference — Sportrix Data Stream](https://docs.sportrixdata.com/api/websocket-messages.md): Complete reference for Sportrix Data WebSocket client messages (subscribe, unsubscribe) and server frames (snapshot, update, error).
- [Sportrix Data WebSocket Stream: Real-Time Live Scores](https://docs.sportrixdata.com/api/websocket-overview.md): Connect to the Sportrix Data WebSocket endpoint to receive real-time live scores and statistics. Requires the live_scores_statistics scope.
- [API Key Authentication – Sportrix Data REST and WebSocket](https://docs.sportrixdata.com/authentication.md): Authenticate every Sportrix Data request with an API key. Learn how to pass the X-API-Key header, handle 401 and 403 errors, and manage keys.
- [Sportrix Data Model: Sports, Leagues, and Match Objects](https://docs.sportrixdata.com/concepts/data-model.md): Understand how Sportrix Data organizes sports data into sports, leagues, and matches — and how live snapshots relate to catalog records.
- [Sportrix Data API Error Codes and JSON Response Format](https://docs.sportrixdata.com/concepts/errors.md): Sportrix Data returns standard HTTP status codes with a JSON body. Learn what each error code means and how to handle auth, permission, and input errors.
- [Paginating Sportrix Data API List Endpoint Responses](https://docs.sportrixdata.com/concepts/pagination.md): Sportrix Data list endpoints return paginated results using limit and offset. Learn how to page through leagues and matches using the pagination envelope.
- [Sportrix Data API Scopes and Permissions Reference](https://docs.sportrixdata.com/concepts/scopes.md): Sportrix Data uses scopes to control which endpoints your API key can access. Learn which scope grants access to fixtures, live scores, and results.
- [Browse Sports, Leagues, and Matches with Sportrix Data](https://docs.sportrixdata.com/guides/browse-fixtures.md): Use the Sportrix Data fixture catalog to list your enabled sports, filter leagues, and query matches by status, date range, and league.
- [Fetch Live Match Scores and Statistics via REST API](https://docs.sportrixdata.com/guides/live-scores-rest.md): Use GET /matches/{id}/live to retrieve the latest in-play score, clock, statistics, and phase for any live match in Sportrix Data.
- [Stream Live Match Scores and Statistics via WebSocket](https://docs.sportrixdata.com/guides/live-scores-websocket.md): Connect to the Sportrix Data WebSocket stream to receive real-time live score and statistics updates. Subscribe to multiple matches on a single connection.
- [Retrieve Half-Time and Full-Time Results per Match](https://docs.sportrixdata.com/guides/match-results.md): Use GET /matches/{id}/result to fetch frozen half-time and full-time snapshots for completed matches, including score, stats, and event timeline.
- [Sportrix Data – Live Scores and Fixtures REST API](https://docs.sportrixdata.com/introduction.md): Sportrix Data provides programmatic access to sports fixtures, live scores, statistics, and final match results via REST API and WebSocket stream.
- [Sportrix Data Quickstart: First REST Call and WebSocket](https://docs.sportrixdata.com/quickstart.md): Learn to call the Sportrix Data REST API and subscribe to the live WebSocket stream with step-by-step curl and Python code examples.