This documentation will help you to get started. You will find code samples in Shell, JavaScript and PHP.
Authenticate your account by including the bearer token in the API requests. You can manage your API Keys within the Dashboard.
All data is returned in JSON format and can easily be parsed in any programming language.
Here's a list of all errors than can occur when using our API.
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request successful |
| 400 | Bad request | Request was invalid |
| 401 | Unauthorized | No API key was found |
| 403 | Forbidden | The API key is invalid |
| 405 | Method Not Allowed | Incorrect HTTP method provided |
| 429 | Too Many Requests | Client is rate limited |
| 500 | Internal Server Error | Server error, please try again later or contact support |
If you need any help or jusst want to say hi, feel free to reach out to our support team.
Use our contact form here and we will be in touch as soon as possible.
curl "https://countryapi.io/api/all?apikey=YOUR-APIKEY"curl GET "https://countryapi.io/api/all" \
-H "Authorization: Bearer YOUR-APIKEY"To display information related to all countries you need to send an API request with the "/all" slug.
GET https://countryapi.io/api/allResponse:
{
"af": {
"name": "Afghanistan",
"official_name": "Islamic Republic of Afghanistan",
"topLevelDomain": [
".af"
],
"alpha2Code": "AF",
"alpha3Code": "AFG",
"cioc": "AFG",
"numericCode": "004",
"callingCode": "+93",
"capital": "Kabul",
"altSpellings": [
"AF",
"Afġānistān"
],
"region": "Asia",
"subregion": "Southern Asia",
"population": 2837743,
"latLng": {
"country": [
33,
65
],
"capital": [
34.52,
69.18
]
},
"demonyms": {
"eng": {
"f": "Afghan",
"m": "Afghan"
},
"fra": {
"f": "Afghane",
"m": "Afghan"
}
},
"area": 652230,
"gini": "Not Available",
"timezones": [
"UTC+04:30"
],
"borders": [
"IRN",
"PAK",
"TKM",
"UZB",
"TJK",
"CHN"
],
"nativeNames": {
"prs": {
"official": "جمهوری اسلامی افغانستان",
"common": "افغانستان"
},
"pus": {
"official": "د افغانستان اسلامي جمهوریت",
"common": "افغانستان"
},
"tuk": {
"official": "Owganystan Yslam Respublikasy",
"common": "Owganystan"
}
},
"currencies": {
"AFN": {
"name": "Afghan afghani",
"symbol": "؋"
}
},
"languages": {
"prs": "Dari",
"pus": "Pashto",
"tuk": "Turkmen"
},
"translations": {
"ara": "أفغانستان",
"ces": "Afghánistán",
"cym": "Affganistan",
"deu": "Afghanistan",
"est": "Afganistan",
"fin": "Afganistan",
"fra": "Afghanistan",
"hrv": "Afganistan",
"hun": "Afganisztán",
"ita": "Afghanistan",
"jpn": "アフガニスタン",
"kor": "아프가니스탄",
"nld": "Afghanistan",
"per": "افغانستان",
"pol": "Afganistan",
"por": "Afeganistão",
"rus": "Афганистан",
"slk": "Afganistan",
"spa": "Afganistán",
"swe": "Afghanistan",
"urd": "افغانستان",
"zho": "阿富汗"
},
"flag": {
"small": "https://flagcdn.com/24x18/af.png",
"medium": "https://flagcdn.com/96x72/af.png",
"large": "https://flagcdn.com/256x192/af.png"
},
"regionalBlocs": [
{
"acronym": "SAARC",
"name": "South Asian Association for Regional Cooperation"
}
]
}
} ....This API call will respond with the information regarding the country that was defined in the API call.
GET https://countryapi.io/api/name/austriaResponse:
{
"at": {
"name": "Austria",
"official_name": "Republic of Austria",
"topLevelDomain": [
".at"
],
"alpha2Code": "AT",
"alpha3Code": "AUT",
"cioc": "AUT",
"numericCode": "040",
"callingCode": "+43",
"capital": "Vienna",
"altSpellings": [
"AT",
"Osterreich",
"Oesterreich"
],
"region": "Europe",
"subregion": "Central Europe",
"population": 8917205,
"latLng": {
"country": [
47.33333333,
13.33333333
],
"capital": [
48.2,
16.37
]
},
"demonyms": {
"eng": {
"f": "Austrian",
"m": "Austrian"
},
"fra": {
"f": "Autrichienne",
"m": "Autrichien"
}
},
"area": 83871,
"gini": {
"2018": 30.8
},
"timezones": [
"UTC+01:00"
],
"borders": [
"CZE",
"DEU",
"HUN",
"ITA",
"LIE",
"SVK",
"SVN",
"CHE"
],
"nativeNames": {
"bar": {
"official": "Republik Österreich",
"common": "Österreich"
}
},
"currencies": {
"EUR": {
"name": "Euro",
"symbol": "€"
}
},
"languages": {
"bar": "Austro-Bavarian German"
},
"translations": {
"ara": "النمسا",
"ces": "Rakousko",
"cym": "Awstria",
"deu": "Österreich",
"est": "Austria",
"fin": "Itävalta",
"fra": "Autriche",
"hrv": "Austrija",
"hun": "Ausztria",
"ita": "Austria",
"jpn": "オーストリア",
"kor": "오스트리아",
"nld": "Oostenrijk",
"per": "اتریش",
"pol": "Austria",
"por": "Áustria",
"rus": "Австрия",
"slk": "Rakúsko",
"spa": "Austria",
"swe": "Österrike",
"urd": "آسٹریا",
"zho": "奥地利"
},
"flag": {
"small": "https://flagcdn.com/24x18/at.png",
"medium": "https://flagcdn.com/96x72/at.png",
"large": "https://flagcdn.com/256x192/at.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
}
}The API will respond with available country data related to the capital.
GET https://countryapi.io/api/capital/berlinResponse:
{
"de": {
"name": "Germany",
"official_name": "Federal Republic of Germany",
"topLevelDomain": [
".de"
],
"alpha2Code": "DE",
"alpha3Code": "DEU",
"cioc": "GER",
"numericCode": "276",
"callingCode": "+49",
"capital": "Berlin",
"altSpellings": [
"DE",
"Federal Republic of Germany",
"Bundesrepublik Deutschland"
],
"region": "Europe",
"subregion": "Western Europe",
"population": 83240525,
"latLng": {
"country": [
51,
9
],
"capital": [
52.52,
13.4
]
},
"demonyms": {
"eng": {
"f": "German",
"m": "German"
},
"fra": {
"f": "Allemande",
"m": "Allemand"
}
},
"area": 357114,
"gini": {
"2016": 31.9
},
"timezones": [
"UTC+01:00"
],
"borders": [
"AUT",
"BEL",
"CZE",
"DNK",
"FRA",
"LUX",
"NLD",
"POL",
"CHE"
],
"nativeNames": {
"deu": {
"official": "Bundesrepublik Deutschland",
"common": "Deutschland"
}
},
"currencies": {
"EUR": {
"name": "Euro",
"symbol": "€"
}
},
"languages": {
"deu": "German"
},
"translations": {
"ara": "ألمانيا",
"ces": "Německo",
"cym": "Germany",
"deu": "Deutschland",
"est": "Saksamaa",
"fin": "Saksa",
"fra": "Allemagne",
"hrv": "Njemačka",
"hun": "Németország",
"ita": "Germania",
"jpn": "ドイツ",
"kor": "독일",
"nld": "Duitsland",
"per": "آلمان",
"pol": "Niemcy",
"por": "Alemanha",
"rus": "Германия",
"slk": "Nemecko",
"spa": "Alemania",
"swe": "Tyskland",
"urd": "جرمنی",
"zho": "德国"
},
"flag": {
"small": "https://flagcdn.com/24x18/de.png",
"medium": "https://flagcdn.com/96x72/de.png",
"large": "https://flagcdn.com/256x192/de.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
}
}This endpoint will return available country data that is defined by the language spoken in the country. For example "german" response are all countries where german is spoken as main language.
GET https://countryapi.io/api/language/swedishResponse:
{
"se": {
"name": "Sweden",
"official_name": "Kingdom of Sweden",
"topLevelDomain": [
".se"
],
"alpha2Code": "SE",
"alpha3Code": "SWE",
"cioc": "SWE",
"numericCode": "752",
"callingCode": "+46",
"capital": "Stockholm",
"altSpellings": [
"SE",
"Kingdom of Sweden",
"Konungariket Sverige"
],
"region": "Europe",
"subregion": "Northern Europe",
"population": 10353442,
"latLng": {
"country": [
62,
15
],
"capital": [
59.33,
18.05
]
},
"demonyms": {
"eng": {
"f": "Swedish",
"m": "Swedish"
},
"fra": {
"f": "Suédoise",
"m": "Suédois"
}
},
"area": 450295,
"gini": {
"2018": 30
},
"timezones": [
"UTC+01:00"
],
"borders": [
"FIN",
"NOR"
],
"nativeNames": {
"swe": {
"official": "Konungariket Sverige",
"common": "Sverige"
}
},
"currencies": {
"SEK": {
"name": "Swedish krona",
"symbol": "kr"
}
},
"languages": {
"swe": "Swedish"
},
"translations": {
"ara": "السويد",
"ces": "Švédsko",
"cym": "Sweden",
"deu": "Schweden",
"est": "Rootsi",
"fin": "Ruotsi",
"fra": "Suède",
"hrv": "Švedska",
"hun": "Svédország",
"ita": "Svezia",
"jpn": "スウェーデン",
"kor": "스웨덴",
"nld": "Zweden",
"per": "سوئد",
"pol": "Szwecja",
"por": "Suécia",
"rus": "Швеция",
"slk": "Švédsko",
"spa": "Suecia",
"swe": "Sverige",
"urd": "سویڈن",
"zho": "瑞典"
},
"flag": {
"small": "https://flagcdn.com/24x18/se.png",
"medium": "https://flagcdn.com/96x72/se.png",
"large": "https://flagcdn.com/256x192/se.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
},
"fi": {
"name": "Finland",
"official_name": "Republic of Finland",
"topLevelDomain": [
".fi"
],
"alpha2Code": "FI",
"alpha3Code": "FIN",
"cioc": "FIN",
"numericCode": "246",
"callingCode": "+358",
"capital": "Helsinki",
"altSpellings": [
"FI",
"Suomi",
"Republic of Finland",
"Suomen tasavalta",
"Republiken Finland"
],
"region": "Europe",
"subregion": "Northern Europe",
"population": 5530719,
"latLng": {
"country": [
64,
26
],
"capital": [
60.17,
24.93
]
},
"demonyms": {
"eng": {
"f": "Finnish",
"m": "Finnish"
},
"fra": {
"f": "Finlandaise",
"m": "Finlandais"
}
},
"area": 338424,
"gini": {
"2018": 27.3
},
"timezones": [
"UTC+02:00"
],
"borders": [
"NOR",
"SWE",
"RUS"
],
"nativeNames": {
"fin": {
"official": "Suomen tasavalta",
"common": "Suomi"
},
"swe": {
"official": "Republiken Finland",
"common": "Finland"
}
},
"currencies": {
"EUR": {
"name": "Euro",
"symbol": "€"
}
},
"languages": {
"fin": "Finnish",
"swe": "Swedish"
},
"translations": {
"ara": "فنلندا",
"ces": "Finsko",
"cym": "Finland",
"deu": "Finnland",
"est": "Soome",
"fin": "Suomi",
"fra": "Finlande",
"hrv": "Finska",
"hun": "Finnország",
"ita": "Finlandia",
"jpn": "フィンランド",
"kor": "핀란드",
"nld": "Finland",
"per": "فنلاند",
"pol": "Finlandia",
"por": "Finlândia",
"rus": "Финляндия",
"slk": "Fínsko",
"spa": "Finlandia",
"swe": "Finland",
"urd": "فن لینڈ",
"zho": "芬兰"
},
"flag": {
"small": "https://flagcdn.com/24x18/fi.png",
"medium": "https://flagcdn.com/96x72/fi.png",
"large": "https://flagcdn.com/256x192/fi.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
},
"ax": {
"name": "Åland Islands",
"official_name": "Åland Islands",
"topLevelDomain": [
".ax"
],
"alpha2Code": "AX",
"alpha3Code": "ALA",
"cioc": "N/A",
"numericCode": "248",
"callingCode": "+35818",
"capital": "Mariehamn",
"altSpellings": [
"AX",
"Aaland",
"Aland",
"Ahvenanmaa"
],
"region": "Europe",
"subregion": "Northern Europe",
"population": 29458,
"latLng": {
"country": [
60.116667,
19.9
],
"capital": [
60.12,
19.9
]
},
"demonyms": {
"eng": {
"f": "Ålandish",
"m": "Ålandish"
},
"fra": {
"f": "Ålandaise",
"m": "Ålandais"
}
},
"area": 1580,
"gini": "Not Available",
"timezones": [
"UTC+02:00"
],
"borders": "N/A",
"nativeNames": {
"swe": {
"official": "Landskapet Åland",
"common": "Åland"
}
},
"currencies": {
"EUR": {
"name": "Euro",
"symbol": "€"
}
},
"languages": {
"swe": "Swedish"
},
"translations": {
"ara": "جزر أولاند",
"ces": "Ålandy",
"cym": "Åland Islands",
"deu": "Åland",
"est": "Ahvenamaa",
"fin": "Ahvenanmaa",
"fra": "Ahvenanmaa",
"hrv": "Ålandski otoci",
"hun": "Åland-szigetek",
"ita": "Isole Aland",
"jpn": "オーランド諸島",
"kor": "올란드 제도",
"nld": "Ålandeilanden",
"per": "جزایر الند",
"pol": "Wyspy Alandzkie",
"por": "Alândia",
"rus": "Аландские острова",
"slk": "Alandy",
"spa": "Alandia",
"swe": "Åland",
"urd": "جزائر اولند",
"zho": "奥兰群岛"
},
"flag": {
"small": "https://flagcdn.com/24x18/ax.png",
"medium": "https://flagcdn.com/96x72/ax.png",
"large": "https://flagcdn.com/256x192/ax.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
}
}This endpoint will return the country data for all countries in the defined region.
GET https://countryapi.io/api/region/europeResponse:
{
"rs": {
"name": "Serbia",
"official_name": "Republic of Serbia",
"topLevelDomain": [
".rs"
],
"alpha2Code": "RS",
"alpha3Code": "SRB",
"cioc": "SRB",
"numericCode": "688",
"callingCode": "+381",
"capital": "Belgrade",
"altSpellings": [
"RS",
"Srbija",
"Republic of Serbia",
"Република Србија",
"Republika Srbija"
],
"region": "Europe",
"subregion": "Southeast Europe",
"population": 6908224,
"latLng": {
"country": [
44,
21
],
"capital": [
44.83,
20.5
]
},
"demonyms": {
"eng": {
"f": "Serbian",
"m": "Serbian"
},
"fra": {
"f": "Serbe",
"m": "Serbe"
}
},
"area": 88361,
"gini": {
"2017": 36.2
},
"timezones": [
"UTC+01:00"
],
"borders": [
"BIH",
"BGR",
"HRV",
"HUN",
"UNK",
"MKD",
"MNE",
"ROU"
],
"nativeNames": {
"srp": {
"official": "Република Србија",
"common": "Србија"
}
},
"currencies": {
"RSD": {
"name": "Serbian dinar",
"symbol": "дин."
}
},
"languages": {
"srp": "Serbian"
},
"translations": {
"ara": "صيربيا",
"ces": "Srbsko",
"cym": "Serbia",
"deu": "Serbien",
"est": "Serbia",
"fin": "Serbia",
"fra": "Serbie",
"hrv": "Srbija",
"hun": "Szerbia",
"ita": "Serbia",
"jpn": "セルビア",
"kor": "세르비아",
"nld": "Servië",
"per": "صربستان",
"pol": "Serbia",
"por": "Sérvia",
"rus": "Сербия",
"slk": "Srbsko",
"spa": "Serbia",
"swe": "Serbien",
"urd": "سربیا",
"zho": "塞尔维亚"
},
"flag": {
"small": "https://flagcdn.com/24x18/rs.png",
"medium": "https://flagcdn.com/96x72/rs.png",
"large": "https://flagcdn.com/256x192/rs.png"
},
"regionalBlocs": [
{
"acronym": "CEFTA",
"name": "Central European Free Trade Agreement"
}
]
},
"mc": {
"name": "Monaco",
"official_name": "Principality of Monaco",
"topLevelDomain": [
".mc"
],
"alpha2Code": "MC",
"alpha3Code": "MCO",
"cioc": "MON",
"numericCode": "492",
"callingCode": "+377",
"capital": "Monaco",
"altSpellings": [
"MC",
"Principality of Monaco",
"Principauté de Monaco"
],
"region": "Europe",
"subregion": "Western Europe",
"population": 39244,
"latLng": {
"country": [
43.73333333,
7.4
],
"capital": [
43.73,
7.42
]
},
"demonyms": {
"eng": {
"f": "Monegasque",
"m": "Monegasque"
},
"fra": {
"f": "Monégasque",
"m": "Monégasque"
}
},
"area": 2.02,
"gini": "Not Available",
"timezones": [
"UTC+01:00"
],
"borders": [
"FRA"
],
"nativeNames": {
"fra": {
"official": "Principauté de Monaco",
"common": "Monaco"
}
},
"currencies": {
"EUR": {
"name": "Euro",
"symbol": "€"
}
},
"languages": {
"fra": "French"
},
"translations": {
"ara": "موناكو",
"ces": "Monako",
"cym": "Monaco",
"deu": "Monaco",
"est": "Monaco",
"fin": "Monaco",
"fra": "Monaco",
"hrv": "Monako",
"hun": "Monaco",
"ita": "Principato di Monaco",
"jpn": "モナコ",
"kor": "모나코",
"nld": "Monaco",
"per": "موناکو",
"pol": "Monako",
"por": "Mónaco",
"rus": "Монако",
"slk": "Monako",
"spa": "Mónaco",
"swe": "Monaco",
"urd": "موناکو",
"zho": "摩纳哥"
},
"flag": {
"small": "https://flagcdn.com/24x18/mc.png",
"medium": "https://flagcdn.com/96x72/mc.png",
"large": "https://flagcdn.com/256x192/mc.png"
},
"regionalBlocs": "N/A"
},
"ba": {
"name": "Bosnia and Herzegovina",
"official_name": "Bosnia and Herzegovina",
"topLevelDomain": [
".ba"
],
"alpha2Code": "BA",
"alpha3Code": "BIH",
"cioc": "BIH",
"numericCode": "070",
"callingCode": "+387",
"capital": "Sarajevo",
"altSpellings": [
"BA",
"Bosnia-Herzegovina",
"Босна и Херцеговина"
],
"region": "Europe",
"subregion": "Southeast Europe",
"population": 3280815,
"latLng": {
"country": [
44,
18
],
"capital": [
43.87,
18.42
]
},
"demonyms": {
"eng": {
"f": "Bosnian, Herzegovinian",
"m": "Bosnian, Herzegovinian"
},
"fra": {
"f": "Bosnienne",
"m": "Bosnien"
}
},
"area": 51209,
"gini": {
"2011": 33
},
"timezones": [
"UTC+01:00"
],
"borders": [
"HRV",
"MNE",
"SRB"
],
"nativeNames": {
"bos": {
"official": "Bosna i Hercegovina",
"common": "Bosna i Hercegovina"
},
"hrv": {
"official": "Bosna i Hercegovina",
"common": "Bosna i Hercegovina"
},
"srp": {
"official": "Боснa и Херцеговина",
"common": "Боснa и Херцеговина"
}
},
"currencies": {
"BAM": {
"name": "Bosnia and Herzegovina convertible mark"
}
},
"languages": {
"bos": "Bosnian",
"hrv": "Croatian",
"srp": "Serbian"
},
"translations": {
"ara": "البوسنة والهرسك",
"ces": "Bosna a Hercegovina",
"cym": "Bosnia a Hercegovina",
"deu": "Bosnien und Herzegowina",
"est": "Bosnia ja Hertsegoviina",
"fin": "Bosnia ja Hertsegovina",
"fra": "Bosnie-Herzégovine",
"hrv": "Bosna i Hercegovina",
"hun": "Bosznia-Hercegovina",
"ita": "Bosnia ed Erzegovina",
"jpn": "ボスニア・ヘルツェゴビナ",
"kor": "보스니아 헤르체고비나",
"nld": "Bosnië en Herzegovina",
"per": "بوسنی و هرزگوین",
"pol": "Bośnia i Hercegowina",
"por": "Bósnia e Herzegovina",
"rus": "Босния и Герцеговина",
"slk": "Bosna a Hercegovina",
"spa": "Bosnia y Herzegovina",
"swe": "Bosnien och Hercegovina",
"urd": "بوسنیا و ہرزیگووینا",
"zho": "波斯尼亚和黑塞哥维那"
},
"flag": {
"small": "https://flagcdn.com/24x18/ba.png",
"medium": "https://flagcdn.com/96x72/ba.png",
"large": "https://flagcdn.com/256x192/ba.png"
},
"regionalBlocs": [
{
"acronym": "CEFTA",
"name": "Central European Free Trade Agreement"
}
]
},
"sj": {
"name": "Svalbard and Jan Mayen",
"official_name": "Svalbard og Jan Mayen",
"topLevelDomain": [
".sj"
],
"alpha2Code": "SJ",
"alpha3Code": "SJM",
"cioc": "N/A",
"numericCode": "744",
"callingCode": "+4779",
"capital": "Longyearbyen",
"altSpellings": [
"SJ",
"Svalbard and Jan Mayen Islands"
],
"region": "Europe",
"subregion": "Northern Europe",
"population": 2562,
"latLng": {
"country": [
78,
20
],
"capital": [
78.22,
15.63
]
},
"demonyms": {
"eng": {
"f": "Norwegian",
"m": "Norwegian"
}
},
"area": -1,
"gini": "Not Available",
"timezones": [
"UTC+01:00"
],
"borders": "N/A",
"nativeNames": {
"nor": {
"official": "Svalbard og Jan Mayen",
"common": "Svalbard og Jan Mayen"
}
},
"currencies": {
"NOK": {
"name": "krone",
"symbol": "kr"
}
},
"languages": {
"nor": "Norwegian"
},
"translations": {
"ara": "سفالبارد ويان ماين",
"ces": "Špicberky a Jan Mayen",
"cym": "Svalbard and Jan Mayen",
"deu": "Spitzbergen und Jan Mayen",
"est": "Svalbard",
"fin": "Huippuvuoret",
"fra": "Svalbard et Jan Mayen",
"hrv": "Svalbard i Jan Mayen",
"hun": "Svalbard és Jan Mayen",
"ita": "Svalbard e Jan Mayen",
"jpn": "スヴァールバル諸島およびヤンマイエン島",
"kor": "스발바르 얀마옌 제도",
"nld": "Svalbard en Jan Mayen",
"per": "سوالبارد و یان ماین",
"pol": "Svalbard i Jan Mayen",
"por": "Ilhas Svalbard e Jan Mayen",
"rus": "Шпицберген и Ян-Майен",
"slk": "Svalbard a Jan Mayen",
"spa": "Islas Svalbard y Jan Mayen",
"swe": "Svalbard och Jan Mayen",
"urd": "سوالبارڈ اور جان میئن",
"zho": "斯瓦尔巴特"
},
"flag": {
"small": "https://flagcdn.com/24x18/sj.png",
"medium": "https://flagcdn.com/96x72/sj.png",
"large": "https://flagcdn.com/256x192/sj.png"
},
"regionalBlocs": "N/A"
},
"se": {
"name": "Sweden",
"official_name": "Kingdom of Sweden",
"topLevelDomain": [
".se"
],
"alpha2Code": "SE",
"alpha3Code": "SWE",
"cioc": "SWE",
"numericCode": "752",
"callingCode": "+46",
"capital": "Stockholm",
"altSpellings": [
"SE",
"Kingdom of Sweden",
"Konungariket Sverige"
],
"region": "Europe",
"subregion": "Northern Europe",
"population": 10353442,
"latLng": {
"country": [
62,
15
],
"capital": [
59.33,
18.05
]
},
"demonyms": {
"eng": {
"f": "Swedish",
"m": "Swedish"
},
"fra": {
"f": "Suédoise",
"m": "Suédois"
}
},
"area": 450295,
"gini": {
"2018": 30
},
"timezones": [
"UTC+01:00"
],
"borders": [
"FIN",
"NOR"
],
"nativeNames": {
"swe": {
"official": "Konungariket Sverige",
"common": "Sverige"
}
},
"currencies": {
"SEK": {
"name": "Swedish krona",
"symbol": "kr"
}
},
"languages": {
"swe": "Swedish"
},
"translations": {
"ara": "السويد",
"ces": "Švédsko",
"cym": "Sweden",
"deu": "Schweden",
"est": "Rootsi",
"fin": "Ruotsi",
"fra": "Suède",
"hrv": "Švedska",
"hun": "Svédország",
"ita": "Svezia",
"jpn": "スウェーデン",
"kor": "스웨덴",
"nld": "Zweden",
"per": "سوئد",
"pol": "Szwecja",
"por": "Suécia",
"rus": "Швеция",
"slk": "Švédsko",
"spa": "Suecia",
"swe": "Sverige",
"urd": "سویڈن",
"zho": "瑞典"
},
"flag": {
"small": "https://flagcdn.com/24x18/se.png",
"medium": "https://flagcdn.com/96x72/se.png",
"large": "https://flagcdn.com/256x192/se.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
},
"al": {
"name": "Albania",
"official_name": "Republic of Albania",
"topLevelDomain": [
".al"
],
"alpha2Code": "AL",
"alpha3Code": "ALB",
"cioc": "ALB",
"numericCode": "008",
"callingCode": "+355",
"capital": "Tirana",
"altSpellings": [
"AL",
"Shqipëri",
"Shqipëria",
"Shqipnia"
],
"region": "Europe",
"subregion": "Southeast Europe",
"population": 2837743,
"latLng": {
"country": [
41,
20
],
"capital": [
41.32,
19.82
]
},
"demonyms": {
"eng": {
"f": "Albanian",
"m": "Albanian"
},
"fra": {
"f": "Albanaise",
"m": "Albanais"
}
},
"area": 28748,
"gini": {
"2017": 33.2
},
"timezones": [
"UTC+01:00"
],
"borders": [
"MNE",
"GRC",
"MKD",
"UNK"
],
"nativeNames": {
"sqi": {
"official": "Republika e Shqipërisë",
"common": "Shqipëria"
}
},
"currencies": {
"ALL": {
"name": "Albanian lek",
"symbol": "L"
}
},
"languages": {
"sqi": "Albanian"
},
"translations": {
"ara": "ألبانيا",
"ces": "Albánie",
"cym": "Albania",
"deu": "Albanien",
"est": "Albaania",
"fin": "Albania",
"fra": "Albanie",
"hrv": "Albanija",
"hun": "Albánia",
"ita": "Albania",
"jpn": "アルバニア",
"kor": "알바니아",
"nld": "Albanië",
"per": "آلبانی",
"pol": "Albania",
"por": "Albânia",
"rus": "Албания",
"slk": "Albánsko",
"spa": "Albania",
"swe": "Albanien",
"urd": "البانیا",
"zho": "阿尔巴尼亚"
},
"flag": {
"small": "https://flagcdn.com/24x18/al.png",
"medium": "https://flagcdn.com/96x72/al.png",
"large": "https://flagcdn.com/256x192/al.png"
},
"regionalBlocs": [
{
"acronym": "CEFTA",
"name": "Central European Free Trade Agreement"
}
]
} ...This API endpoint will return all countries that are using the defined currency in their country.
GET https://countryapi.io/api/currency/randResponse:
{
"sz": {
"name": "Eswatini",
"official_name": "Kingdom of Eswatini",
"topLevelDomain": [
".sz"
],
"alpha2Code": "SZ",
"alpha3Code": "SWZ",
"cioc": "SWZ",
"numericCode": "748",
"callingCode": "+268",
"capital": "Mbabane",
"altSpellings": [
"SZ",
"Swaziland",
"weSwatini",
"Swatini",
"Ngwane",
"Kingdom of Eswatini",
"Umbuso weSwatini"
],
"region": "Africa",
"subregion": "Southern Africa",
"population": 1160164,
"latLng": {
"country": [
-26.5,
31.5
],
"capital": [
-26.32,
31.13
]
},
"demonyms": {
"eng": {
"f": "Swazi",
"m": "Swazi"
},
"fra": {
"f": "Swazie",
"m": "Swazie"
}
},
"area": 17364,
"gini": {
"2016": 54.6
},
"timezones": [
"UTC+02:00"
],
"borders": [
"MOZ",
"ZAF"
],
"nativeNames": {
"eng": {
"official": "Kingdom of Eswatini",
"common": "Eswatini"
},
"ssw": {
"official": "Umbuso weSwatini",
"common": "eSwatini"
}
},
"currencies": {
"SZL": {
"name": "Swazi lilangeni",
"symbol": "L"
},
"ZAR": {
"name": "South African rand",
"symbol": "R"
}
},
"languages": {
"eng": "English",
"ssw": "Swazi"
},
"translations": {
"ara": "إسواتيني",
"ces": "Svazijsko",
"cym": "Eswatini",
"deu": "Swasiland",
"est": "Svaasimaa",
"fin": "Swazimaa",
"fra": "Swaziland",
"hrv": "Svazi",
"hun": "Szváziföld",
"ita": "Swaziland",
"jpn": "スワジランド",
"kor": "에스와티니",
"nld": "Swaziland",
"per": "اسواتینی",
"pol": "Suazi",
"por": "Suazilândia",
"rus": "Свазиленд",
"slk": "Svazijsko",
"spa": "Suazilandia",
"swe": "Swaziland",
"urd": "سوازی لینڈ",
"zho": "斯威士兰"
},
"flag": {
"small": "https://flagcdn.com/24x18/sz.png",
"medium": "https://flagcdn.com/96x72/sz.png",
"large": "https://flagcdn.com/256x192/sz.png"
},
"regionalBlocs": [
{
"acronym": "AU",
"name": "African Union",
"otherNames": [
"الاتحاد الأفريقي",
"Union africaine",
"União Africana",
"Unión Africana",
"Umoja wa Afrika"
]
}
]
},
"na": {
"name": "Namibia",
"official_name": "Republic of Namibia",
"topLevelDomain": [
".na"
],
"alpha2Code": "NA",
"alpha3Code": "NAM",
"cioc": "NAM",
"numericCode": "516",
"callingCode": "+264",
"capital": "Windhoek",
"altSpellings": [
"NA",
"Namibië",
"Republic of Namibia"
],
"region": "Africa",
"subregion": "Southern Africa",
"population": 2540916,
"latLng": {
"country": [
-22,
17
],
"capital": [
-22.57,
17.08
]
},
"demonyms": {
"eng": {
"f": "Namibian",
"m": "Namibian"
},
"fra": {
"f": "Namibienne",
"m": "Namibien"
}
},
"area": 825615,
"gini": {
"2015": 59.1
},
"timezones": [
"UTC+01:00"
],
"borders": [
"AGO",
"BWA",
"ZAF",
"ZMB"
],
"nativeNames": {
"afr": {
"official": "Republiek van Namibië",
"common": "Namibië"
},
"deu": {
"official": "Republik Namibia",
"common": "Namibia"
},
"eng": {
"official": "Republic of Namibia",
"common": "Namibia"
},
"her": {
"official": "Republic of Namibia",
"common": "Namibia"
},
"hgm": {
"official": "Republic of Namibia",
"common": "Namibia"
},
"kwn": {
"official": "Republic of Namibia",
"common": "Namibia"
},
"loz": {
"official": "Republic of Namibia",
"common": "Namibia"
},
"ndo": {
"official": "Republic of Namibia",
"common": "Namibia"
},
"tsn": {
"official": "Lefatshe la Namibia",
"common": "Namibia"
}
},
"currencies": {
"NAD": {
"name": "Namibian dollar",
"symbol": "$"
},
"ZAR": {
"name": "South African rand",
"symbol": "R"
}
},
"languages": {
"afr": "Afrikaans",
"deu": "German",
"eng": "English",
"her": "Herero",
"hgm": "Khoekhoe",
"kwn": "Kwangali",
"loz": "Lozi",
"ndo": "Ndonga",
"tsn": "Tswana"
},
"translations": {
"ara": "ناميبيا",
"ces": "Namibie",
"cym": "Namibia",
"deu": "Namibia",
"est": "Namiibia",
"fin": "Namibia",
"fra": "Namibie",
"hrv": "Namibija",
"hun": "Namíbia",
"ita": "Namibia",
"jpn": "ナミビア",
"kor": "나미비아",
"nld": "Namibië",
"per": "نامیبیا",
"pol": "Namibia",
"por": "Namíbia",
"rus": "Намибия",
"slk": "Namíbia",
"spa": "Namibia",
"swe": "Namibia",
"urd": "نمیبیا",
"zho": "纳米比亚"
},
"flag": {
"small": "https://flagcdn.com/24x18/na.png",
"medium": "https://flagcdn.com/96x72/na.png",
"large": "https://flagcdn.com/256x192/na.png"
},
"regionalBlocs": [
{
"acronym": "AU",
"name": "African Union",
"otherNames": [
"الاتحاد الأفريقي",
"Union africaine",
"União Africana",
"Unión Africana",
"Umoja wa Afrika"
]
}
]
},
"za": {
"name": "South Africa",
"official_name": "Republic of South Africa",
"topLevelDomain": [
".za"
],
"alpha2Code": "ZA",
"alpha3Code": "ZAF",
"cioc": "RSA",
"numericCode": "710",
"callingCode": "+27",
"capital": "Pretoria",
"altSpellings": [
"ZA",
"RSA",
"Suid-Afrika",
"Republic of South Africa"
],
"region": "Africa",
"subregion": "Southern Africa",
"population": 59308690,
"latLng": {
"country": [
-29,
24
],
"capital": [
-25.7,
28.22
]
},
"demonyms": {
"eng": {
"f": "South African",
"m": "South African"
},
"fra": {
"f": "Sud-africaine",
"m": "Sud-africain"
}
},
"area": 1221037,
"gini": {
"2014": 63
},
"timezones": [
"UTC+02:00"
],
"borders": [
"BWA",
"LSO",
"MOZ",
"NAM",
"SWZ",
"ZWE"
],
"nativeNames": {
"afr": {
"official": "Republiek van Suid-Afrika",
"common": "South Africa"
},
"eng": {
"official": "Republic of South Africa",
"common": "South Africa"
},
"nbl": {
"official": "IRiphabliki yeSewula Afrika",
"common": "Sewula Afrika"
},
"nso": {
"official": "Rephaboliki ya Afrika-Borwa ",
"common": "Afrika-Borwa"
},
"sot": {
"official": "Rephaboliki ya Afrika Borwa",
"common": "Afrika Borwa"
},
"ssw": {
"official": "IRiphabhulikhi yeNingizimu Afrika",
"common": "Ningizimu Afrika"
},
"tsn": {
"official": "Rephaboliki ya Aforika Borwa",
"common": "Aforika Borwa"
},
"tso": {
"official": "Riphabliki ra Afrika Dzonga",
"common": "Afrika Dzonga"
},
"ven": {
"official": "Riphabuḽiki ya Afurika Tshipembe",
"common": "Afurika Tshipembe"
},
"xho": {
"official": "IRiphabliki yaseMzantsi Afrika",
"common": "Mzantsi Afrika"
},
"zul": {
"official": "IRiphabliki yaseNingizimu Afrika",
"common": "Ningizimu Afrika"
}
},
"currencies": {
"ZAR": {
"name": "South African rand",
"symbol": "R"
}
},
"languages": {
"afr": "Afrikaans",
"eng": "English",
"nbl": "Southern Ndebele",
"nso": "Northern Sotho",
"sot": "Southern Sotho",
"ssw": "Swazi",
"tsn": "Tswana",
"tso": "Tsonga",
"ven": "Venda",
"xho": "Xhosa",
"zul": "Zulu"
},
"translations": {
"ara": "جنوب أفريقيا",
"ces": "Jihoafrická republika",
"cym": "South Africa",
"deu": "Südafrika",
"est": "Lõuna-Aafrika Vabariik",
"fin": "Etelä-Afrikka",
"fra": "Afrique du Sud",
"hrv": "Južnoafrička Republika",
"hun": "Dél-afrikai Köztársaság",
"ita": "Sud Africa",
"jpn": "南アフリカ",
"kor": "남아프리카",
"nld": "Zuid-Afrika",
"per": "آفریقای جنوبی",
"pol": "Południowa Afryka",
"por": "África do Sul",
"rus": "Южно-Африканская Республика",
"slk": "Juhoafrická republika",
"spa": "República de Sudáfrica",
"swe": "Sydafrika",
"urd": "جنوبی افریقا",
"zho": "南非"
},
"flag": {
"small": "https://flagcdn.com/24x18/za.png",
"medium": "https://flagcdn.com/96x72/za.png",
"large": "https://flagcdn.com/256x192/za.png"
},
"regionalBlocs": [
{
"acronym": "AU",
"name": "African Union",
"otherNames": [
"الاتحاد الأفريقي",
"Union africaine",
"União Africana",
"Unión Africana",
"Umoja wa Afrika"
]
}
]
},
"ls": {
"name": "Lesotho",
"official_name": "Kingdom of Lesotho",
"topLevelDomain": [
".ls"
],
"alpha2Code": "LS",
"alpha3Code": "LSO",
"cioc": "LES",
"numericCode": "426",
"callingCode": "+266",
"capital": "Maseru",
"altSpellings": [
"LS",
"Kingdom of Lesotho",
"Muso oa Lesotho"
],
"region": "Africa",
"subregion": "Southern Africa",
"population": 2142252,
"latLng": {
"country": [
-29.5,
28.5
],
"capital": [
-29.32,
27.48
]
},
"demonyms": {
"eng": {
"f": "Mosotho",
"m": "Mosotho"
},
"fra": {
"f": "Lésothienne",
"m": "Lésothien"
}
},
"area": 30355,
"gini": {
"2017": 44.9
},
"timezones": [
"UTC+02:00"
],
"borders": [
"ZAF"
],
"nativeNames": {
"eng": {
"official": "Kingdom of Lesotho",
"common": "Lesotho"
},
"sot": {
"official": "Kingdom of Lesotho",
"common": "Lesotho"
}
},
"currencies": {
"LSL": {
"name": "Lesotho loti",
"symbol": "L"
},
"ZAR": {
"name": "South African rand",
"symbol": "R"
}
},
"languages": {
"eng": "English",
"sot": "Sotho"
},
"translations": {
"ara": "ليسوتو",
"ces": "Lesotho",
"cym": "Lesotho",
"deu": "Lesotho",
"est": "Lesotho",
"fin": "Lesotho",
"fra": "Lesotho",
"hrv": "Lesoto",
"hun": "Lesotho",
"ita": "Lesotho",
"jpn": "レソト",
"kor": "레소토",
"nld": "Lesotho",
"per": "لسوتو",
"pol": "Lesotho",
"por": "Lesoto",
"rus": "Лесото",
"slk": "Lesotho",
"spa": "Lesotho",
"swe": "Lesotho",
"urd": "لیسوتھو",
"zho": "莱索托"
},
"flag": {
"small": "https://flagcdn.com/24x18/ls.png",
"medium": "https://flagcdn.com/96x72/ls.png",
"large": "https://flagcdn.com/256x192/ls.png"
},
"regionalBlocs": [
{
"acronym": "AU",
"name": "African Union",
"otherNames": [
"الاتحاد الأفريقي",
"Union africaine",
"União Africana",
"Unión Africana",
"Umoja wa Afrika"
]
}
]
}
}Outputs the country data of the defined region block. For example if "EU" is defined it will display all information related to member states of the european union.
GET https://countryapi.io/api/regionbloc/euResponse:
{
"se": {
"name": "Sweden",
"official_name": "Kingdom of Sweden",
"topLevelDomain": [
".se"
],
"alpha2Code": "SE",
"alpha3Code": "SWE",
"cioc": "SWE",
"numericCode": "752",
"callingCode": "+46",
"capital": "Stockholm",
"altSpellings": [
"SE",
"Kingdom of Sweden",
"Konungariket Sverige"
],
"region": "Europe",
"subregion": "Northern Europe",
"population": 10353442,
"latLng": {
"country": [
62,
15
],
"capital": [
59.33,
18.05
]
},
"demonyms": {
"eng": {
"f": "Swedish",
"m": "Swedish"
},
"fra": {
"f": "Suédoise",
"m": "Suédois"
}
},
"area": 450295,
"gini": {
"2018": 30
},
"timezones": [
"UTC+01:00"
],
"borders": [
"FIN",
"NOR"
],
"nativeNames": {
"swe": {
"official": "Konungariket Sverige",
"common": "Sverige"
}
},
"currencies": {
"SEK": {
"name": "Swedish krona",
"symbol": "kr"
}
},
"languages": {
"swe": "Swedish"
},
"translations": {
"ara": "السويد",
"ces": "Švédsko",
"cym": "Sweden",
"deu": "Schweden",
"est": "Rootsi",
"fin": "Ruotsi",
"fra": "Suède",
"hrv": "Švedska",
"hun": "Svédország",
"ita": "Svezia",
"jpn": "スウェーデン",
"kor": "스웨덴",
"nld": "Zweden",
"per": "سوئد",
"pol": "Szwecja",
"por": "Suécia",
"rus": "Швеция",
"slk": "Švédsko",
"spa": "Suecia",
"swe": "Sverige",
"urd": "سویڈن",
"zho": "瑞典"
},
"flag": {
"small": "https://flagcdn.com/24x18/se.png",
"medium": "https://flagcdn.com/96x72/se.png",
"large": "https://flagcdn.com/256x192/se.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
},
"lu": {
"name": "Luxembourg",
"official_name": "Grand Duchy of Luxembourg",
"topLevelDomain": [
".lu"
],
"alpha2Code": "LU",
"alpha3Code": "LUX",
"cioc": "LUX",
"numericCode": "442",
"callingCode": "+352",
"capital": "Luxembourg",
"altSpellings": [
"LU",
"Grand Duchy of Luxembourg",
"Grand-Duché de Luxembourg",
"Großherzogtum Luxemburg",
"Groussherzogtum Lëtzebuerg"
],
"region": "Europe",
"subregion": "Western Europe",
"population": 632275,
"latLng": {
"country": [
49.75,
6.16666666
],
"capital": [
49.6,
6.12
]
},
"demonyms": {
"eng": {
"f": "Luxembourger",
"m": "Luxembourger"
},
"fra": {
"f": "Luxembourgeoise",
"m": "Luxembourgeois"
}
},
"area": 2586,
"gini": {
"2018": 35.4
},
"timezones": [
"UTC+01:00"
],
"borders": [
"BEL",
"FRA",
"DEU"
],
"nativeNames": {
"deu": {
"official": "Großherzogtum Luxemburg",
"common": "Luxemburg"
},
"fra": {
"official": "Grand-Duché de Luxembourg",
"common": "Luxembourg"
},
"ltz": {
"official": "Groussherzogtum Lëtzebuerg",
"common": "Lëtzebuerg"
}
},
"currencies": {
"EUR": {
"name": "Euro",
"symbol": "€"
}
},
"languages": {
"deu": "German",
"fra": "French",
"ltz": "Luxembourgish"
},
"translations": {
"ara": "لوكسمبورغ",
"ces": "Lucembursko",
"cym": "Luxembourg",
"deu": "Luxemburg",
"est": "Luksemburg",
"fin": "Luxemburg",
"fra": "Luxembourg",
"hrv": "Luksemburg",
"hun": "Luxemburg",
"ita": "Lussemburgo",
"jpn": "ルクセンブルク",
"kor": "룩셈부르크",
"nld": "Luxemburg",
"per": "لوکزامبورگ",
"pol": "Luksemburg",
"por": "Luxemburgo",
"rus": "Люксембург",
"slk": "Luxembursko",
"spa": "Luxemburgo",
"swe": "Luxemburg",
"urd": "لکسمبرگ",
"zho": "卢森堡"
},
"flag": {
"small": "https://flagcdn.com/24x18/lu.png",
"medium": "https://flagcdn.com/96x72/lu.png",
"large": "https://flagcdn.com/256x192/lu.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
} ...This endpoints displays the available country information of the country matching the defined calling code.
GET https://countryapi.io/api/callingcode/353Response:
{
"ie": {
"name": "Ireland",
"official_name": "Republic of Ireland",
"topLevelDomain": [
".ie"
],
"alpha2Code": "IE",
"alpha3Code": "IRL",
"cioc": "IRL",
"numericCode": "372",
"callingCode": "+353",
"capital": "Dublin",
"altSpellings": [
"IE",
"Éire",
"Republic of Ireland",
"Poblacht na hÉireann"
],
"region": "Europe",
"subregion": "Northern Europe",
"population": 4994724,
"latLng": {
"country": [
53,
-8
],
"capital": [
53.32,
-6.23
]
},
"demonyms": {
"eng": {
"f": "Irish",
"m": "Irish"
},
"fra": {
"f": "Irlandaise",
"m": "Irlandais"
}
},
"area": 70273,
"gini": {
"2017": 31.4
},
"timezones": [
"UTC"
],
"borders": [
"GBR"
],
"nativeNames": {
"eng": {
"official": "Republic of Ireland",
"common": "Ireland"
},
"gle": {
"official": "Poblacht na hÉireann",
"common": "Éire"
}
},
"currencies": {
"EUR": {
"name": "Euro",
"symbol": "€"
}
},
"languages": {
"eng": "English",
"gle": "Irish"
},
"translations": {
"ara": "أيرلندا",
"ces": "Irsko",
"cym": "Ireland",
"deu": "Irland",
"est": "Iirimaa",
"fin": "Irlanti",
"fra": "Irlande",
"hrv": "Irska",
"hun": "Írország",
"ita": "Irlanda",
"jpn": "アイルランド",
"kor": "아일랜드",
"nld": "Ierland",
"per": "ایرلند",
"pol": "Irlandia",
"por": "Irlanda",
"rus": "Ирландия",
"slk": "Írsko",
"spa": "Irlanda",
"swe": "Irland",
"urd": "جزیرہ آئرلینڈ",
"zho": "爱尔兰"
},
"flag": {
"small": "https://flagcdn.com/24x18/ie.png",
"medium": "https://flagcdn.com/96x72/ie.png",
"large": "https://flagcdn.com/256x192/ie.png"
},
"regionalBlocs": [
{
"acronym": "EU",
"name": "European Union"
}
]
}
}