Documentation

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 1 tokens.

Each NORMAL request will spend 2 tokens.

Each ADVANCED request will spend 3 tokens.

Each ALL request will spend 4 tokens.

Query Params

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"
        }
      },
      ...
    ]