{ "error": "Unauthorized. You shouldn't be here."}
Retrieve detailed information for a specific country using its ISO2 code, including extended geographical, currency, and timezone data.
Availability: All plans (Community and above). The fields returned vary by tier — see Tier-Based Field Availability below.
Trim response columns: Add ?fields=name,iso2,... to receive only the columns you need. Available on Starter+ plans. See the Field Filtering & Sorting guide for syntax.
curl -X GET 'https://api.countrystatecity.in/v1/countries/IN' \ -H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/countries/IN?include_translations=true' \ -H 'X-CSCAPI-KEY: YOUR_API_KEY'
translations is part of Full access but is not returned by default: add include_translations=true, or name it in ?fields=. localized_name and matched_locale are computed from the translations rather than stored, and appear only when you pass locale. See Localized Place Names.See Pricing for plan details.
Comma-separated list of fields to include in the response. id is always included. Requires Starter+ plan.
Example:
"name,iso2,capital"
locale
string
BCP 47 locale code (e.g. pt-BR) to request a localized name. Adds localized_name (resolved via exact locale → base language → native name → English name fallback) and matched_locale (which tier matched) to the result; name is unaffected. Supporter+ plans only — silently omitted (not an error) on lower tiers. A malformed value is rejected with a 400 on every tier.
Required string length: 2 - 7
Pattern: ^[a-zA-Z]{2}(-[a-zA-Z]{2,4})?$
Example:
"pt-BR"
include_translations
boolean
default:false
When true, includes the full translations field (JSON string keyed by language code). Supporter+ plans only — silently omitted (not an error) on lower tiers. Note that an explicit fields=translations also returns the field and takes precedence over this flag.
Example:
true
Response
Country details
Country object. Fields returned depend on your plan's data access level.
id
integer<int64>
required
Unique identifier
Example:
101
name
string
required
Country name in English
Example:
"India"
iso2
string
required
ISO 3166-1 alpha-2 code
Example:
"IN"
iso3
string
required
ISO 3166-1 alpha-3 code
Example:
"IND"
phonecode
string
International dialling code
Example:
"91"
capital
string | null
Capital city name
Example:
"New Delhi"
currency
string | null
Currency code
Example:
"INR"
native
string | null
Country name in native language
Example:
"भारत"
emoji
string | null
Flag emoji
Example:
"🇮🇳"
latitude
string | null
Latitude coordinate
Example:
"20.00000000"
longitude
string | null
Longitude coordinate
Example:
"77.00000000"
region
string | null
Geographic region
Example:
"Asia"
region_id
integer | null
Region identifier
subregion
string | null
Geographic subregion
Example:
"Southern Asia"
subregion_id
integer | null
Subregion identifier
timezones
string | null
JSON string of timezone objects with zoneName, gmtOffset, gmtOffsetName, abbreviation, tzName
Example:
"[{\"zoneName\":\"Asia/Kolkata\",\"gmtOffset\":19800,\"gmtOffsetName\":\"UTC+05:30\",\"abbreviation\":\"IST\",\"tzName\":\"Indian Standard Time\"}]"
numeric_code
string | null
ISO 3166-1 numeric code. Coordinates tier and above.
Example:
"356"
currency_name
string | null
Full currency name. Coordinates tier and above.
Example:
"Indian rupee"
currency_symbol
string | null
Currency symbol. Coordinates tier and above.
Example:
"₹"
tld
string | null
Top-level domain. Coordinates tier and above.
Example:
".in"
nationality
string | null
Nationality/demonym. Coordinates tier and above.
Example:
"Indian"
population
integer<int64> | null
Population count. Coordinates tier and above.
gdp
integer<int64> | null
Gross domestic product (USD). Coordinates tier and above.
area_sq_km
number | null
Area in square kilometres. Coordinates tier and above.
postal_code_format
string | null
Postal code format pattern. Coordinates tier and above.
postal_code_regex
string | null
Postal code validation regex. Coordinates tier and above.
emojiU
string | null
Flag emoji Unicode points. Coordinates tier and above.
Example:
"U+1F1EE U+1F1F3"
translations
string | null
JSON string keyed by language code. Supporter+ plans only. Returned when include_translations=true or when fields=translations explicitly requests it.
wikiDataId
string | null
Wikidata item identifier. Full access level only.
Example:
"Q668"
localized_name
string | null
Name resolved via the locale query param's fallback chain (exact locale → base language → native name → English name). Only present when locale was supplied. Supporter+ plans only — silently omitted on lower tiers.
Example:
"Índia"
matched_locale
string | null
Which fallback tier satisfied the locale request: the exact locale (e.g. pt-BR), its base language (e.g. pt), native, or en (English fallback). Only present when locale was supplied. Supporter+ plans only — silently omitted on lower tiers.