FOOTBALL API USAGE

Usage

Complimentary keyMCP tool check_usage

Your plan, your calls today, your limits and when they reset. Calling it never counts against your allowance. Every key can call it.

GET/v1/usage

TRY ITComplimentary

X-API-Key

Kept in this browser for every docs page. No key yet? Get a free key

GET https://api.footballapi.org/v1/usage

The answer appears below, with its status and time.

curl "https://api.footballapi.org/v1/usage" \
  -H "X-API-Key: your key"

RETURNS

planstringYour plan

readsstringWhat your key reads

livebooleanWhether your key reads live scores

calls_todayintegerCalls counted today, UTC

limit_per_dayintegerCalls a day; null for no ceiling

limit_per_minuteintegerCalls a minute

resets_atstringWhen the day's count goes back to nought, UTC

keystringThe start of the key you called with

key_statusstringactive, or when a replaced key stops working

EXAMPLE ANSWER

200GET /v1/usage, taken 21 Oct 2026

{
  "data": {
    "plan": "Complimentary key",
    "reads": "This season's Premier League",
    "live": false,
    "calls_today": 0,
    "limit_per_day": 50,
    "limit_per_minute": 10,
    "resets_at": "2026-10-22T00:00:00Z",
    "key": "fa_live_7Q2M...",
    "key_status": "active"
  },
  "meta": {
    "request_id": "req_bb839cb2a75ca9bf"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.

422unknown_parameterA parameter this endpoint does not take.

429rate_limitedMore than your plan's calls a minute.

PREVIOUSPositions and results