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.