Get all countries
By passing in the options, you can filter the list of countries. All countries are returned by default
Query parameters
-
independent boolean
Boolean indicating if the country is considered independent. Default: ALL
-
un-member boolean
Boolean indicating if the country is member of the UN. Default: ALL
-
languages string
Comma-separated list of language ISO Alpha-2 or Alpha-3 codes. Countries that has at least one of the specified languages as their main language(s) will be returned.
-
continents string
Comma-separated list of continents. Countries that are part of any of the continents specified will be returned.
-
regions string
Comma-separated list of region names. Countries are part of any of the regions specified will be returned. Keep in mind regions are not the same as continents.
-
subregions string
Comma-separated list of sub-region names. Countries are part of any of the sub-regions specified will be returned
-
capitals string
Comma-separated list of capital names. Countries are has of any of the capitals specified will be returned.
-
currencies string
Comma-separated list of currency codes. Countries that uses any of the currencies specified will be returned.
-
callingcodes string
Comma-separated list of calling codes. Countries that uses any of the calling codes specified will be returned.
-
timezones string
Comma-separated list of timezones. Countries that uses any of the timezones specified will be returned.
-
search string
Search by country (english) common name
-
strict-search boolean
Boolean dictating if country name must start with the search query
-
minimal boolean
Boolean dictating if the returned payload should only contain the bare essential data, to reduce response size by more than 40%
curl \
-X GET https://api.tellusdb.com/v1/countries?token=api_token_value{
"result": [
{
"name": {
"common": "Denmark",
"official": "Kingdom of Denmark",
"native": {
"dan": {
"common": "Danmark",
"official": "Kongeriget Danmark"
}
},
"translations": {
"spa": {
"common": "Dinamarca",
"official": "Reino de Dinamarca"
},
"ita": {
"common": "Danimarca",
"official": "Regno di Danimarca"
}
},
"alternatives": [
"DK",
"Denmark",
"Kingdom of Denmark",
"Kongeriget Danmark"
]
},
"tld": [
".dk"
],
"status": "officially-assigned",
"currencies": {
"DKK": {
"name": "Danish Krone",
"symbol": "kr"
}
},
"capital": [
"Copenhagen"
],
"region": "Europe",
"subregion": "Northern Europe",
"languages": {
"dan": "Danish"
},
"landlocked": false,
"borders": [
"DEU"
],
"area": {
"m2": 43094,
"sqft": 463859.95
},
"flag": {
"emoji": "🇩🇰",
"svg": "https://api.tellusdb.com/v1/countries/flags/svg/dnk.svg",
"png": "https://api.tellusdb.com/v1/countries/flags/png/dk.png"
},
"demonyms": {
"fra": {
"f": "Danoise",
"m": "Danois"
}
},
"coordinates": {
"latitude": 56,
"longitude": 10
},
"continent": {
"code": "EU",
"name": "Europe",
"others": [
{
"code": "NA",
"name": "North America"
}
]
},
"calling": {
"base": "+45",
"idd": {
"root": "+4",
"suffixes": [
"5"
]
},
"codes": [
"+45"
]
},
"political": {
"is_independent": true,
"is_un_member": true
},
"iso3166": {
"alpha2": "DK",
"alpha3": "DNK",
"numeric": "208"
},
"purchasing_power": {
"year": 2022,
"value": 6.404699
},
"addressing": {
"labels": {
"state": "State",
"zip": "ZIP Code",
"city": "City",
"district": "District"
},
"zip_regex": "\\d{4}",
"zip_examples": [
"8660",
"1566"
],
"fields": {
"available": [
"name",
"company_name",
"street",
"zip",
"city"
],
"required": [
"street",
"zip",
"city"
]
}
},
"states": {
"81": "Northern Denmark",
"82": "Central Denmark",
"83": "Southern Denmark",
"84": "Capital Region",
"85": "Zealand"
}
}
],
"count": 250,
"time_taken_ms": 1.3892211
}