🌍

Country Information

Get country details including capital, currency, languages, and flag by ISO code

GET 1 credit /v1/geo/country-info

curl "https://geo.toolkitapi.io/v1/geo/country-info?code=DE"

import httpx

resp = httpx.get(
    "https://geo.toolkitapi.io/v1/geo/country-info?code=DE",
)
print(resp.json())

const resp = await fetch("https://geo.toolkitapi.io/v1/geo/country-info?code=DE", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "code": "DE",
  "name": "Germany",
  "official_name": "Federal Republic of Germany",
  "capital": "Berlin",
  "continent": "Europe",
  "region": "Western Europe",
  "subregion": "Western Europe",
  "currency_code": "EUR",
  "currency_name": "Euro",
  "calling_code": "+49",
  "languages": ["German"],
  "flag_emoji": "🇩🇪",
  "tld": ".de",
  "population": 83240525,
  "area_km2": 357114.0
}

Try It Live

Description

Get country details including capital, currency, languages, and flag by ISO code

How to Use

1

1. Pass the ISO 3166-1 alpha-2 country code (e.g. `US`, `GB`, `DE`) in the `code` parameter.

2

2. Send a GET request — both upper and lowercase codes are accepted.

3

3. Use the response fields to populate UI elements, validate addresses, or enrich analytics data.

About This Tool

Use Country Information to retrieve detailed data about any country by its ISO 3166-1 alpha-2 code. The response includes the capital city, currency, calling code, languages, flag emoji, population, area, and geographic classification.

This is useful for building localisation features, populating country pickers, validating user input, or enriching records with geographic metadata without maintaining your own country database.

Why Use This Tool

Localisation — Display currency symbols and calling codes based on user country
Form validation — Verify country codes in address or shipping forms
Analytics enrichment — Add country metadata to IP-geolocated records
Country pickers — Build searchable dropdowns with flag emojis and names

Frequently Asked Questions

What country code format is accepted?

ISO 3166-1 alpha-2 codes (2 letters) are accepted. Both upper and lowercase work — the API normalises to uppercase internally.

What happens if the country code is not found?

A 404 error is returned with a message indicating the code was not found.

Does this include dependent territories?

The data set covers sovereign nations and some dependent territories that have their own ISO codes. Coverage depends on the underlying countries.json data file.

Start using Country Information now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs