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.