Get a country

GET /countries/{countryCode}

Find country by ISO-3166 alpha2 or alpha3 code (DK, GB, US, ...)

Path parameters

  • countryCode string Required

    ISO-3166 Alpha2 or Alpha3 code for country

Responses

GET /countries/{countryCode}
curl \
 -X GET https://api.tellusdb.com/v1/countries/US?token=api_token_value
Response examples (200)
{
  "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"
    }
  },
  "time_taken_ms": 1.3892211
}