Get information about countries via a RESTful API https://restcountries.eu

The restcountries project has been acquired by apilayer, one of the leading providers of API microservices. We will keep supporting restcountries and providing it as a free solution for developers. We will finance this project fully and have turned off the donations feature.

RESTCountries has over 1200 users, including:

TTÜ

Spotify International Pricing Index

Gorillaz

Wanderlust

Xero

FxPro

SKROSS

onefinestay

Much Better Adventures

Follow RESTCountries on Twitter

Or subscribe to the mailing list

Below are described the REST endpoints available that you can use to search for countries

https://restcountries.eu/rest/v2/all

Search by country name. It can be the native name or partial name

https://restcountries.eu/rest/v2/name/{name}

https://restcountries.eu/rest/v2/name/eesti

https://restcountries.eu/rest/v2/name/united

Search by country full name

https://restcountries.eu/rest/v2/name/{name}?fullText=true

https://restcountries.eu/rest/v2/name/aruba?fullText=true

Search by ISO 3166-1 2-letter or 3-letter country code

https://restcountries.eu/rest/v2/alpha/{code}

https://restcountries.eu/rest/v2/alpha/co

https://restcountries.eu/rest/v2/alpha/col

Search by list of ISO 3166-1 2-letter or 3-letter country codes

https://restcountries.eu/rest/v2/alpha?codes={code};{code};{code}

https://restcountries.eu/rest/v2/alpha?codes=col;no;ee

Search by ISO 4217 currency code

https://restcountries.eu/rest/v2/currency/{currency}

https://restcountries.eu/rest/v2/currency/cop

Search by ISO 639-1 language code

https://restcountries.eu/rest/v2/lang/{et}

https://restcountries.eu/rest/v2/lang/es

Search by capital city

https://restcountries.eu/rest/v2/capital/{capital}

https://restcountries.eu/rest/v2/capital/tallinn

Search by calling code

https://restcountries.eu/rest/v2/callingcode/{callingcode}

https://restcountries.eu/rest/v2/callingcode/372

Search by region: Africa, Americas, Asia, Europe, Oceania

https://restcountries.eu/rest/v2/region/{region}

https://restcountries.eu/rest/v2/region/europe

Search by regional bloc:

• EU (European Union)
• EFTA (European Free Trade Association)
• CARICOM (Caribbean Community)
• PA (Pacific Alliance)
• AU (African Union)
• USAN (Union of South American Nations)
• EEU (Eurasian Economic Union)
• AL (Arab League)
• ASEAN (Association of Southeast Asian Nations)
• CAIS (Central American Integration System)
• CEFTA (Central European Free Trade Agreement)
• NAFTA (North American Free Trade Agreement)
• SAARC (South Asian Association for Regional Cooperation)

https://restcountries.eu/rest/v2/regionalbloc/{regionalbloc}

https://restcountries.eu/rest/v2/regionalbloc/eu

https://restcountries.eu/rest/v2/alpha/col

[[{ "name": "Colombia", "topLevelDomain": [".co"], "alpha2Code": "CO", "alpha3Code": "COL", "callingCodes": ["57"], "capital": "Bogotá", "altSpellings": ["CO", "Republic of Colombia", "República de Colombia"], "region": "Americas", "subregion": "South America", "population": 48759958, "latlng": [4.0, -72.0], "demonym": "Colombian", "area": 1141748.0, "gini": 55.9, "timezones": ["UTC-05:00"], "borders": ["BRA", "ECU", "PAN", "PER", "VEN"], "nativeName": "Colombia", "numericCode": "170", "currencies": [{ "code": "COP", "name": "Colombian peso", "symbol": "$"	}], "languages": [{ "iso639_1": "es", "iso639_2": "spa", "name": "Spanish", "nativeName": "Español"	}], "translations": { "de": "Kolumbien", "es": "Colombia", "fr": "Colombie", "ja": "コロンビア", "it": "Colombia", "br": "Colômbia", "pt": "Colômbia"	}, "flag": "https://restcountries.eu/data/col.svg", "regionalBlocs": [{ "acronym": "PA", "name": "Pacific Alliance", "otherAcronyms": [], "otherNames": ["Alianza del Pacífico"]	}, { "acronym": "USAN", "name": "Union of South American Nations", "otherAcronyms": ["UNASUR", "UNASUL", "UZAN"], "otherNames": ["Unión de Naciones Suramericanas", "União de Nações Sul-Americanas", "Unie van Zuid-Amerikaanse Naties", "South American Union"]	}] }]

You can filter the output of your request to include only the specified fields.

https://restcountries.eu/rest/v2/{service}?fields={field};{field};{field}

https://restcountries.eu/rest/v2/all?fields=name;capital;currencies

• @mledoze
• List of countries
• Languages
• Currencies
• Area

• Countries of the world
• REST Countries Node.js
• REST Countries Ruby
• REST Countries Go
• REST Countries Python
• world-currencies
• REST Countries C#

Mozilla Public License MPL 2.0