Skip to main content
The SportriX REST API gives you access to a sports fixture catalog, live score snapshots, and post-match results through a straightforward HTTP interface. Every response is JSON, and all paths described in this documentation are relative to the single base URL below.

​
Base URL

All REST API requests are made to:
For example, GET /sports resolves to GET https://api.sportrix.ai/api/sports.

​
Authentication

Include your API key in the X-API-Key header on every request:
A missing, unknown, disabled, or expired key returns 401 Unauthorized. The only endpoint that does not require authentication is GET /health.

​
Response Format

All responses are JSON. List endpoints return a pagination envelope. Single-resource endpoints return the object directly.

​
Dates and Times

All timestamps are ISO 8601 in UTC. For example:
Query parameters that accept a datetime (start_after, start_before) use the same format.

​
Match Status Values

Catalog endpoints expose exactly three status values: Matches that the provider has marked suspended or postponed are never returned — they are filtered out of every catalog response.

​
Pagination

List endpoints (/leagues, /leagues/active, /teams, /matches, /matches/active) accept limit and offset query parameters and return a pagination envelope. See the Pagination guide for the full envelope schema and examples.

​
Errors

Errors use standard HTTP status codes with a JSON body:
See the Errors reference for the full list of status codes.

​
Endpoint Quick Reference