FOOTBALL API
Sign inRequest a key
The collectionDocumentationMembershipStatusSupport
Sign inRequest a key
Documentation / Competitions

FOOTBALL COUNTRIES API

Countries
Complimentary key

Every country in the collection, with how many of its competitions are served and their names. Every key can call it.

GET/v1/countries
TRY ITComplimentary
Kept in this browser for every docs page. No key yet? Get a free key
GET https://api.footballapi.org/v1/countries
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/countries" \
  -H "X-API-Key: your key"

RETURNS

countrystringThe country, or Europe or World for a competition across countries
competitionsintegerHow many of its competitions the collection serves
nameslistTheir names in the collection

EXAMPLE ANSWER

200GET /v1/countries, taken 21 Oct 2026, first rows shown
{
  "data": [
    {
      "country": "Europe",
      "competitions": 6,
      "names": [
        "champions-league",
        "europa-league",
        "conference-league"
      ]
    },
    {
      "country": "World",
      "competitions": 2,
      "names": [
        "world-cup",
        "world-cup-qualifiers"
      ]
    }
  ],
  "meta": {
    "count": 32,
    "request_id": "req_04a22bc2bb9c2c3f"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.
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.
PREVIOUSCompetitionNEXTSeason