All Countries
Country Data API provides detailed information about +200 different countries
HTTP GET
https://api.countrydataapi.com/v1/countries/all
Returns a list of all registered countries.
There are 4 types of operations:
-
BASIC: Returns the fields id, lang, country_name, country_short_iso, country_phone_code, country_cca2, country_ccn3, country_cca3, country_cioc.
-
NORMAL: Returns the previous fields and adds country_independent, country_status, country_unMember, country_flag, country_map_googleMaps, country_map_openStreetMaps, country_fifa, country_flag_png, country_flag_svg, country_flag_alt, country_coatOfArms_png, country_coatOfArms_svg, country_startofWeek, country_continent_code, country_current_currency, country_GDP, country_location, country_land, country_terrain, country_climate, country_natural_hazards, country_note, country_history, country_GDP_per_capita_PPP, country_life_expectancy, country_median_age, country_birth_rate, country_death_rate, country_sex_ratio, country_literacy, country_roadways, country_airports, country_railways, country_waterways, country_heliports, country_airports_paved, country_wikipedia_url.
-
ADVANCED: Returns the previous fields and adds country_car_info, country_idd_info.
-
ALL: Returns the previous fields and adds country_tld, country_capital, country_altSpellings, country_latLng, country_borders, country_timezones, country_continents, country_currencies, country_languages, country_translations, country_capital_info, country_demonyms, country_name_additional_info.
Each BASIC request will spend 10 tokens.
Each NORMAL request will spend 25 tokens.
Each ADVANCED request will spend 40 tokens.
Each ALL request will spend 75 tokens.
Query Params
| Parametro | Tipo | Descripción |
|---|---|---|
| apikey | required, token | Your account’s authentication API key |
| limit | optional, number | 100 (default). Maximum number of countries to be returned |
| limitToken | optional, number | 1000 (default). Maximum number of tokens you want to spend on this request |
| type | optional, string | basic (default), normal, advanced, or all |
| lang | optional, lang | en (default). Expected language of the response |
Example Response
[
{
"id": "a0436505-66a2-4e7a-8010-9a003d59e786",
"lang": "en",
"country_name": "Afghanistan",
"country_short_iso": "AF",
"country_phone_code": "93",
"country_cca2": "AF",
"country_ccn3": "004",
"country_cca3": "AFG",
"country_cioc": "AFG",
"country_tld": [
".af"
],
"country_capital": [
"Kabul"
],
"country_altSpellings": [
"AF",
"Afġānistān"
],
"country_latLng": [
"33",
"65"
],
"country_borders": [
"IRN",
"PAK",
"TKM",
"UZB",
"TJK",
"CHN"
],
"country_timezones": [
"UTC+04:30"
],
"country_continents": [
"Asia"
],
"country_currencies": [
{
"currency": "AFN",
"name": "Afghan afghani",
"symbol": "؋",
"_id": "65f851997afaffabdae9c97e"
}
],
"country_languages": [
{
"language": "prs",
"name": "Dari",
"_id": "65f851997afaffabdae9c97f"
},
{
"language": "pus",
"name": "Pashto",
"_id": "65f851997afaffabdae9c980"
},
{
"language": "tuk",
"name": "Turkmen",
"_id": "65f851997afaffabdae9c981"
}
],
"country_translations": [
{
"translation": "ara",
"official": "جمهورية أففانستان الإسلامية",
"common": "أفغانستان",
"_id": "65f851997afaffabdae9c982"
},
{
"translation": "bre",
"official": "Republik Islamek Afghanistan",
"common": "Afghanistan",
"_id": "65f851997afaffabdae9c983"
},
{
"translation": "ces",
"official": "Afghánská islámská republika",
"common": "Afghánistán",
"_id": "65f851997afaffabdae9c984"
},
{
"translation": "cym",
"official": "Gweriniaeth Islamaidd Affganistan",
"common": "Affganistan",
"_id": "65f851997afaffabdae9c985"
},
{
"translation": "deu",
"official": "Islamische Republik Afghanistan",
"common": "Afghanistan",
"_id": "65f851997afaffabdae9c986"
},
{
"translation": "est",
"official": "Afganistani Islamivabariik",
"common": "Afganistan",
"_id": "65f851997afaffabdae9c987"
},
{
"translation": "fin",
"official": "Afganistanin islamilainen tasavalta",
"common": "Afganistan",
"_id": "65f851997afaffabdae9c988"
},
{
"translation": "fra",
"official": "République islamique d'Afghanistan",
"common": "Afghanistan",
"_id": "65f851997afaffabdae9c989"
},
{
"translation": "hrv",
"official": "Islamska Republika Afganistan",
"common": "Afganistan",
"_id": "65f851997afaffabdae9c98a"
},
{
"translation": "hun",
"official": "Afganisztáni Iszlám Köztársaság",
"common": "Afganisztán",
"_id": "65f851997afaffabdae9c98b"
},
{
"translation": "ita",
"official": "Repubblica islamica dell'Afghanistan",
"common": "Afghanistan",
"_id": "65f851997afaffabdae9c98c"
},
{
"translation": "jpn",
"official": "アフガニスタン·イスラム共和国",
"common": "アフガニスタン",
"_id": "65f851997afaffabdae9c98d"
},
{
"translation": "kor",
"official": "아프가니스탄 이슬람 공화국",
"common": "아프가니스탄",
"_id": "65f851997afaffabdae9c98e"
},
{
"translation": "nld",
"official": "Islamitische Republiek Afghanistan",
"common": "Afghanistan",
"_id": "65f851997afaffabdae9c98f"
},
{
"translation": "per",
"official": "جمهوری اسلامی افغانستان",
"common": "افغانستان",
"_id": "65f851997afaffabdae9c990"
},
{
"translation": "pol",
"official": "Islamska Republika Afganistanu",
"common": "Afganistan",
"_id": "65f851997afaffabdae9c991"
},
{
"translation": "por",
"official": "República Islâmica do Afeganistão",
"common": "Afeganistão",
"_id": "65f851997afaffabdae9c992"
},
{
"translation": "rus",
"official": "Исламская Республика Афганистан",
"common": "Афганистан",
"_id": "65f851997afaffabdae9c993"
},
{
"translation": "slk",
"official": "Afgánsky islamský štát",
"common": "Afganistan",
"_id": "65f851997afaffabdae9c994"
},
{
"translation": "spa",
"official": "República Islámica de Afganistán",
"common": "Afganistán",
"_id": "65f851997afaffabdae9c995"
},
{
"translation": "srp",
"official": "Исламска Република Авганистан",
"common": "Авганистан",
"_id": "65f851997afaffabdae9c996"
},
{
"translation": "swe",
"official": "Islamiska republiken Afghanistan",
"common": "Afghanistan",
"_id": "65f851997afaffabdae9c997"
},
{
"translation": "tur",
"official": "Afganistan İslam Cumhuriyeti",
"common": "Afganistan",
"_id": "65f851997afaffabdae9c998"
},
{
"translation": "urd",
"official": "اسلامی جمہوریہ افغانستان",
"common": "افغانستان",
"_id": "65f851997afaffabdae9c999"
},
{
"translation": "zho",
"official": "阿富汗伊斯兰共和国",
"common": "阿富汗",
"_id": "65f851997afaffabdae9c99a"
}
],
"country_capital_info": [
{
"lat": "34.52",
"lng": "69.18",
"_id": "65f851997afaffabdae9c99c"
}
],
"country_demonyms": [
{
"lang": "eng",
"f": "Afghan",
"m": "Afghan",
"_id": "65f851997afaffabdae9c99d"
},
{
"lang": "fra",
"f": "Afghane",
"m": "Afghan",
"_id": "65f851997afaffabdae9c99e"
}
],
"country_name_additional_info": {
"common": "Afghanistan",
"official": "Islamic Republic of Afghanistan",
"nativeName": [
{
"lang": "PRS",
"official": "جمهوری اسلامی افغانستان",
"common": "افغانستان",
"_id": "65f851997afaffabdae9c9a0"
},
{
"lang": "PUS",
"official": "د افغانستان اسلامي جمهوریت",
"common": "افغانستان",
"_id": "65f851997afaffabdae9c9a1"
},
{
"lang": "TUK",
"official": "Owganystan Yslam Respublikasy",
"common": "Owganystan",
"_id": "65f851997afaffabdae9c9a2"
}
],
"_id": "65f851997afaffabdae9c99f"
}
},
...
]