List countries

List countries

GET /v1/countries

The countries leagues belong to, each with its code — the value /v1/leagues?country= takes. Codes are ISO 3166-1 alpha-2 (DE, BR, JP); the football home nations use their ISO 3166-2 subdivision (GB-ENG, GB-SCT, GB-WLS, GB-NIR); continental and international competitions sit under region codes — EUROPE, ASIA, AFRICA, AMERICAS, OCEANIA and WORLD (e.g. the UEFA Champions League is EUROPE, the World Cup is WORLD). The region rows are listed first, then countries alphabetically by English name.

Parameters

search optional Match on country name.
lang optional Localize country names (21 languages besides English, e.g. zh-cn, zh-tw, ja, es, de, pt). Unrecognized non-country rows fall back to English.
page, per_page optional Pagination.

Example

GET /v1/countries
curl https://api.5dollarfootballapi.com/v1/countries
  -H "Authorization: Bearer fb_live_your_key"
{
  "success": 1,
  "data": [
    { "code": "WORLD", "name": "International" },
    { "code": "EUROPE", "name": "Europe" },
    { "code": "AMERICAS", "name": "America" },
    { "code": "AF", "name": "Afghanistan" },
    { "code": "AL", "name": "Albania" }
  ],
  "pagination": { "page": 1, "per_page": 50, "count": 5, "has_more": true }
}

Need a key? Create a free account — a working key is issued instantly, no card required.