Skip to main content
GET
https://api.countrystatecity.in
/
v1
/
countries
/
{iso2}
curl -X GET 'https://api.countrystatecity.in/v1/countries/IN' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

{
  "id": 101,
  "name": "India",
  "iso3": "IND",
  "numeric_code": "356",
  "iso2": "IN",
  "phonecode": "91",
  "capital": "New Delhi",
  "currency": "INR",
  "currency_name": "Indian rupee",
  "currency_symbol": "₹",
  "tld": ".in",
  "native": "भारत",
  "region": "Asia",
  "region_id": 3,
  "subregion": "Southern Asia",
  "subregion_id": 14,
  "nationality": "Indian",
  "timezones": "[{\"zoneName\":\"Asia/Kolkata\",\"gmtOffset\":19800,\"gmtOffsetName\":\"UTC+05:30\",\"abbreviation\":\"IST\",\"tzName\":\"Indian Standard Time\"}]",
  "translations": "{\"kr\":\"인도\",\"pt-BR\":\"Índia\",\"pt\":\"Índia\",\"nl\":\"India\",\"hr\":\"Indija\",\"fa\":\"هند\",\"de\":\"Indien\",\"es\":\"India\",\"fr\":\"Inde\",\"ja\":\"インド\",\"it\":\"India\",\"cn\":\"印度\",\"tr\":\"Hindistan\"}",
  "latitude": "20.00000000",
  "longitude": "77.00000000",
  "emoji": "🇮🇳",
  "emojiU": "U+1F1EE U+1F1F3"
}
Retrieve detailed information for a specific country using its ISO2 code, including extended geographical, currency, and timezone data.

​
Path Parameters

​
iso2
string
required
ISO2 code of the country (e.g., “IN” for India, “US” for United States)

​
Authentication

​
X-CSCAPI-KEY
string
required
Your API key for authentication

​
Response

​
id
integer
Unique identifier for the country
​
name
string
Official country name in English
​
iso2
string
Two-letter ISO 3166-1 alpha-2 country code
​
iso3
string
Three-letter ISO 3166-1 alpha-3 country code
​
numeric_code
string
Three-digit numeric country code
​
phonecode
string
International dialing code for the country
​
capital
string
Capital city of the country
​
currency
string
Three-letter ISO 4217 currency code
​
currency_name
string
Full name of the currency
​
currency_symbol
string
Currency symbol (e.g., $, €, ₹)
​
tld
string
Top-level domain for the country
​
native
string
Country name in the native language
​
region
string
Geographic region (e.g., Asia, Europe, Americas)
​
subregion
string
Geographic subregion (e.g., Southern Asia, Western Europe)
​
nationality
string
Demonym for the country’s residents
​
timezones
string
JSON string containing timezone information
​
translations
string
JSON string containing country name translations
​
latitude
string
Country’s approximate latitude coordinate
​
longitude
string
Country’s approximate longitude coordinate
​
emoji
string
Flag emoji representation
​
emojiU
string
Unicode representation of the flag emoji
curl -X GET 'https://api.countrystatecity.in/v1/countries/IN' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

{
  "id": 101,
  "name": "India",
  "iso3": "IND",
  "numeric_code": "356",
  "iso2": "IN",
  "phonecode": "91",
  "capital": "New Delhi",
  "currency": "INR",
  "currency_name": "Indian rupee",
  "currency_symbol": "₹",
  "tld": ".in",
  "native": "भारत",
  "region": "Asia",
  "region_id": 3,
  "subregion": "Southern Asia",
  "subregion_id": 14,
  "nationality": "Indian",
  "timezones": "[{\"zoneName\":\"Asia/Kolkata\",\"gmtOffset\":19800,\"gmtOffsetName\":\"UTC+05:30\",\"abbreviation\":\"IST\",\"tzName\":\"Indian Standard Time\"}]",
  "translations": "{\"kr\":\"인도\",\"pt-BR\":\"Índia\",\"pt\":\"Índia\",\"nl\":\"India\",\"hr\":\"Indija\",\"fa\":\"هند\",\"de\":\"Indien\",\"es\":\"India\",\"fr\":\"Inde\",\"ja\":\"インド\",\"it\":\"India\",\"cn\":\"印度\",\"tr\":\"Hindistan\"}",
  "latitude": "20.00000000",
  "longitude": "77.00000000",
  "emoji": "🇮🇳",
  "emojiU": "U+1F1EE U+1F1F3"
}

​
Common Use Cases

Use native names and translations for multi-language applications.
const getLocalizedCountryName = (country, language = 'en') => {
  if (language === 'native') return country.native;
  
  const translations = JSON.parse(country.translations || '{}');
  return translations[language] || country.name;
};
Parse and use timezone data for scheduling applications.
const getTimezoneInfo = (country) => {
  const timezones = JSON.parse(country.timezones || '[]');
  return timezones.map(tz => ({
    name: tz.zoneName,
    offset: tz.gmtOffsetName,
    abbreviation: tz.abbreviation
  }));
};
Use this endpoint when you need detailed country information for user profiles, shipping calculations, or localization features.