curl -X GET 'https://api.countrystatecity.in/v1/regions/3/subregions' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/regions/3/subregions', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const subregions = await response.json();
console.log(subregions);
[
{ "id": 14, "name": "Southern Asia", "region_id": 3 },
{ "id": 15, "name": "Eastern Asia", "region_id": 3 },
{ "id": 16, "name": "South-Eastern Asia", "region_id": 3 },
{ "id": 17, "name": "Western Asia", "region_id": 3 },
{ "id": 18, "name": "Central Asia", "region_id": 3 }
]
Get Subregions by Region
Retrieve subregions within a geographic region
curl -X GET 'https://api.countrystatecity.in/v1/regions/3/subregions' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/regions/3/subregions', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const subregions = await response.json();
console.log(subregions);
[
{ "id": 14, "name": "Southern Asia", "region_id": 3 },
{ "id": 15, "name": "Eastern Asia", "region_id": 3 },
{ "id": 16, "name": "South-Eastern Asia", "region_id": 3 },
{ "id": 17, "name": "Western Asia", "region_id": 3 },
{ "id": 18, "name": "Central Asia", "region_id": 3 }
]
?fields= to limit columns returned, or ?sort= to order the list. Both are available on Starter+ plans. See the Field Filtering & Sorting guide for syntax and per-entity sortable fields.curl -X GET 'https://api.countrystatecity.in/v1/regions/3/subregions' \
-H 'X-CSCAPI-KEY: YOUR_API_KEY'
const response = await fetch('https://api.countrystatecity.in/v1/regions/3/subregions', {
headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});
const subregions = await response.json();
console.log(subregions);
[
{ "id": 14, "name": "Southern Asia", "region_id": 3 },
{ "id": 15, "name": "Eastern Asia", "region_id": 3 },
{ "id": 16, "name": "South-Eastern Asia", "region_id": 3 },
{ "id": 17, "name": "Western Asia", "region_id": 3 },
{ "id": 18, "name": "Central Asia", "region_id": 3 }
]
Authorizations
API key for authentication. Get your free key at app.countrystatecity.in.
Path Parameters
Numeric region ID
3
Query Parameters
Search filter on subregion name. Min 2 characters.
2 - 100Comma-separated list of fields to include in the response. id is always included. Requires Starter+ plan.
"name,region_id"
Comma-separated sort tokens: field or field:asc|desc. Requires Starter+ plan.
"name:asc"
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 each 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
List of subregions
Unique identifier
14
Subregion name
"Southern Asia"
Parent region ID
3
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 Meridional"
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.