FOOTBALL COMPETITIONS API

Competitions

Complimentary keyMCP tool list_competitions

Every league and competition in the collection with its country, its tier, the first season served, and whether your key reads it. Every key can call it.

GET/v1/competitions

TRY ITComplimentary

X-API-Key

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

country

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

The answer appears below, with its status and time.

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

PARAMETERS

countrystringOnly this country, such as England.

RETURNS

competitionstringThe competition's name in the collection, such as premier-league

namestringThe competition as people write it

countrystringThe country, or Europe or World for a competition across countries

tiernull or moreThe league's level in its country, 1 for the top flight

kindstringLeague, or the kind of competition

sincestringThe first season served

your_key_readsbooleanWhether your key reads it

EXAMPLE ANSWER

200GET /v1/competitions, taken 21 Oct 2026, first rows shown

{
  "data": [
    {
      "competition": "champions-league",
      "name": "Champions League",
      "country": "Europe",
      "tier": null,
      "kind": "Club, Europe",
      "since": "2015/16",
      "your_key_reads": true
    },
    {
      "competition": "europa-league",
      "name": "Europa League",
      "country": "Europe",
      "tier": null,
      "kind": "Club, Europe",
      "since": "2015/16",
      "your_key_reads": true
    }
  ],
  "meta": {
    "count": 68,
    "request_id": "req_791e5810855471ef"
  }
}

ERRORS

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

400bad_requestA parameter is missing or not in the right form; the message names it.

422unknown_parameterA parameter this endpoint does not take.

429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.

PREVIOUSChangelog NEXTCompetition