Authentication
Every /v1/football request requires an API key. Send it in the X-API-Key header, or use Authorization Bearer:
shell
curl 'https://api.footyquanta.com/v1/football/countries' -H "X-API-Key: $FQ_API_KEY" curl 'https://api.footyquanta.com/v1/football/countries' -H "Authorization: Bearer $FQ_API_KEY"
Keys are not accepted in query parameters. FQ_API_KEY in these examples is a server-side environment variable.
Manage keys
- Create and revoke keys in the console.
- The full key is shown only once. Only its hash is stored, so it cannot be displayed again.
- All keys share the account's monthly quota and per-minute request limit.
- Key status is cached. Changes may take up to approximately five minutes to propagate.
Keep keys secret
Call the API from your server. Do not embed keys in browser or mobile application bundles. If a key leaks, create a replacement and revoke the old key.
A missing or invalid key returns 401. An unavailable plan feature returns 403. See errors and rate limits.