Get Subregions by Region

Retrieve subregions within a geographic region

GET /v1/regions/{id}/subregions

cURL

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);

200 - Success

[
  { "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 }
]

Retrieve all subregions belonging to a specific region. For example, region “Asia” contains subregions like “Southern Asia”, “Eastern Asia”, etc.

Availability: Supporter plan and above.

Trim and order results: Add ?fields= to limit columns returned, or ?sort= to order the list. Both are available on Supporter+ plans. See the Field Filtering & Sorting guide for syntax and per-entity sortable fields.

Authentication

X-CSCAPI-KEY · string · required

Your API key for authentication

Path Parameters

id · integer · required

Numeric region ID (e.g., 3 for Asia)

Query Parameters

q · string

Search filter on subregion name. Min 2 characters. Requires Supporter+ plan.

Response

id · integer

Unique identifier for the subregion

name · string

Subregion name

region_id · integer

Parent region ID

cURL

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);

200 - Success

[
  { "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 }
]