curl -X GET 'https://api.countrystatecity.in/v1/regions/3' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/regions/3?include_translations=true' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/regions/3', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const region = await response.json();
console.log(region);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/regions/3',
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
region = response.json()
print(region)
{
"id": 3,
"name": "Asia"
}
{
"id": 3,
"name": "Asia",
"wikiDataId": "Q48",
"translations": "{\"kr\":\"아시아\",\"pt\":\"Ásia\",\"nl\":\"Azië\",\"hr\":\"Azija\",\"fa\":\"آسیا\",\"de\":\"Asien\",\"es\":\"Asia\",\"fr\":\"Asie\",\"ja\":\"アジア\",\"it\":\"Asia\",\"cn\":\"亚洲\",\"tr\":\"Asya\"}"
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "regionsApi",
"currentTier": "community",
"requiredTier": "starter",
"upgradeUrl": "https://app.countrystatecity.in/pricing"
}
}
{
"error": "Region not found."
}
Get Region Details
Retrieve a single geographic region by its numeric ID
curl -X GET 'https://api.countrystatecity.in/v1/regions/3' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/regions/3?include_translations=true' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/regions/3', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const region = await response.json();
console.log(region);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/regions/3',
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
region = response.json()
print(region)
{
"id": 3,
"name": "Asia"
}
{
"id": 3,
"name": "Asia",
"wikiDataId": "Q48",
"translations": "{\"kr\":\"아시아\",\"pt\":\"Ásia\",\"nl\":\"Azië\",\"hr\":\"Azija\",\"fa\":\"آسیا\",\"de\":\"Asien\",\"es\":\"Asia\",\"fr\":\"Asie\",\"ja\":\"アジア\",\"it\":\"Asia\",\"cn\":\"亚洲\",\"tr\":\"Asya\"}"
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "regionsApi",
"currentTier": "community",
"requiredTier": "starter",
"upgradeUrl": "https://app.countrystatecity.in/pricing"
}
}
{
"error": "Region not found."
}
403 on lower tiers.?fields=id,name 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/regions/3' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
curl -X GET 'https://api.countrystatecity.in/v1/regions/3?include_translations=true' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/regions/3', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const region = await response.json();
console.log(region);
import requests
response = requests.get(
'https://api.countrystatecity.in/v1/regions/3',
headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)
region = response.json()
print(region)
{
"id": 3,
"name": "Asia"
}
{
"id": 3,
"name": "Asia",
"wikiDataId": "Q48",
"translations": "{\"kr\":\"아시아\",\"pt\":\"Ásia\",\"nl\":\"Azië\",\"hr\":\"Azija\",\"fa\":\"آسیا\",\"de\":\"Asien\",\"es\":\"Asia\",\"fr\":\"Asie\",\"ja\":\"アジア\",\"it\":\"Asia\",\"cn\":\"亚洲\",\"tr\":\"Asya\"}"
}
{
"status": "error",
"message": "This feature is not available on your current plan.",
"details": {
"feature": "regionsApi",
"currentTier": "community",
"requiredTier": "starter",
"upgradeUrl": "https://app.countrystatecity.in/pricing"
}
}
{
"error": "Region not found."
}
Related Endpoints
- Get All Regions — list every region
- Get Subregions of a Region — drill down into subregions
Authorizations
API key for authentication. Get your free key at app.countrystatecity.in.
Path Parameters
Numeric region ID
3
Query Parameters
Comma-separated list of fields to include in the response. id is always included. Requires Starter+ plan.
"name,wikiDataId"
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.
2 - 7^[a-zA-Z]{2}(-[a-zA-Z]{2,4})?$"pt-BR"
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.
true
Response
Region details
Geographic region. Fields returned depend on your plan's data access level.
Unique identifier
3
Region name
"Asia"
JSON string keyed by language code. Supporter+ plans only. Returned when include_translations=true or when fields=translations explicitly requests it.
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.
"Ásia"
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.
"pt"
Wikidata item identifier. Coordinates tier and above.