Country Data API
All countries with ISO codes, names in any language, native name, capital, continent, calling codes, currencies, languages and emoji flag. Filter by continent, currency, language or search.
Authentication & base URL
Subscribe through one of our marketplace listings; your marketplace API key and base URL are shown there. All endpoints return JSON over HTTPS, served from a global edge network (typically 20–150 ms).
Endpoints
GET /v1/countries
List / search countries
| Parameter | In | Description | Example |
|---|---|---|---|
continent | query | Continent code (EU, AS, AF, NA, SA, OC, AN) | EU |
currency | query | Currency code | EUR |
language | query | Language code | |
q | query | Search text | |
lang | query | Language for localized names | en |
GET /v1/countries/{code}
Country by code
| Parameter | In | Description | Example |
|---|---|---|---|
code * | path | ISO 3166-1 alpha-2 | ES |
lang | query | Language for localized name | es |
Example
GET /v1/countries?continent=EU¤cy=EUR&language=&q=&lang=en
{
"count": 28,
"countries": [
{
"code": "AD",
"name": "Andorra",
"localizedName": "Andorra",
"native": "Andorra",
"capital": "Andorra la Vella",
"continent": "EU",
"continentName": "Europe",
"phone": [
376
],
"currency": [
"EUR"
],
"languages": [
"ca"
],
"flag": "🇦🇩"
},
{
"code": "AT",
"name": "Austria",
"localizedName": "Austria",
"native": "Österreich",
"capital": "Vienna",
"continent": "EU",
"continentName": "Europe",
"phone": [
43
],
"currency": [
"EUR"
],
"languages": [
"de"
],
"flag": "🇦🇹"
},
{
"code": "AX",
"name": "Aland",
"localizedName": "Åland Islands",
"native": "Åland",
"capital": "Mariehamn",
"continent": "EU",
"continentName": "Europe",
"phone": [
358
],
"currency": [
"EUR"
],
"languages": [
"sv"
],
"flag": "🇦🇽"
},
{
"code": "BE",
"name": "Belgium",
"localizedName": "Belgium",
"native": "België",
"capital": "Brussels",
"continent": "EU",
"continentName": "Europe",
"phone": [
32
…All countries with ISO codes, names in any language, native name, capital, continent, calling codes, currencies, languages and emoji flag. Filter by continent, currency, language or search.
Use cases
Country pickers, checkout forms, phone prefixes, currency selection, localization.
Why this API
- Fast: runs on a global edge network, typical response well under 1 second.
- Reliable: simple JSON, clear error messages.
- Fair pricing: Free plan 500 requests/month, Pro 25,000 for $4.99, Ultra 150,000 for $14.99.
Pricing
Free plan with 500 calls per month, then Pro (25,000 calls for $4.99/month) and Ultra (150,000 calls for $14.99/month). See all plans.