API Sandbox
x-api-key
API Documentation
Integrate live and historical football data directly into your applications. Base URL for all endpoints is
https://your-domain.com/api/v1
Authentication
All API requests require an API key to be passed via the
x-api-key request header.
Example Request
curl -H "x-api-key: YOUR_API_KEY" https://api.your-domain.com/api/v1/countries
Rate Limits
Your API key is bound to a specific requests-per-minute rate limit. Every API response includes headers detailing your current usage:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Your total requests allowed per minute. |
| X-RateLimit-Remaining | Requests remaining in the current window. |
| X-RateLimit-Reset | Unix timestamp when the limit resets. |
If you exceed your limit, the API will return a
429 Too Many Requests status code.