Get Countries by Subregion

Retrieve countries belonging to a specific subregion

GET /v1/subregions/{id}/countries

cURL

curl -X GET 'https://api.countrystatecity.in/v1/subregions/14/countries' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

const response = await fetch('https://api.countrystatecity.in/v1/subregions/14/countries', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const countries = await response.json();
console.log(countries);

200 - Supporter tier (Coordinates) — abridged

[
  {
    "id": 101,
    "name": "India",
    "iso2": "IN",
    "iso3": "IND",
    "phonecode": "91",
    "capital": "New Delhi",
    "currency": "INR",
    "currency_name": "Indian rupee",
    "currency_symbol": "₹",
    "tld": ".in",
    "nationality": "Indian",
    "native": "भारत",
    "emoji": "🇮🇳",
    "emojiU": "U+1F1EE U+1F1F3",
    "latitude": "20.00000000",
    "longitude": "77.00000000",
    "region": "Asia",
    "region_id": 3,
    "subregion": "Southern Asia",
    "subregion_id": 14,
    "timezones": "[{\"zoneName\":\"Asia/Kolkata\",\"gmtOffset\":19800,\"gmtOffsetName\":\"UTC+05:30\",\"abbreviation\":\"IST\",\"tzName\":\"Indian Standard Time\"}]",
    "population": 1380004385,
    "gdp": 2870504000000,
    "area_sq_km": 3287263,
    "postal_code_format": "######",
    "postal_code_regex": "^(\\d{6})$",
    "numeric_code": "356"
  }
]

{
  "error": "This feature is not available on your current plan.",
  "feature": "regionsApi",
  "upgradeUrl": "https://app.countrystatecity.in/pricing"
}

Retrieve all countries within a subregion. For example, subregion “Southern Asia” contains India, Pakistan, Bangladesh, 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 subregion ID (e.g., 14 for Southern Asia)

Query Parameters

q · string

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

Response

Returns the same country object as Get All Countries, filtered to the subregion.

cURL

curl -X GET 'https://api.countrystatecity.in/v1/subregions/14/countries' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

const response = await fetch('https://api.countrystatecity.in/v1/subregions/14/countries', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const countries = await response.json();
console.log(countries);

200 - Supporter tier (Coordinates) — abridged

[
  {
    "id": 101,
    "name": "India",
    "iso2": "IN",
    "iso3": "IND",
    "phonecode": "91",
    "capital": "New Delhi",
    "currency": "INR",
    "currency_name": "Indian rupee",
    "currency_symbol": "₹",
    "tld": ".in",
    "nationality": "Indian",
    "native": "भारत",
    "emoji": "🇮🇳",
    "emojiU": "U+1F1EE U+1F1F3",
    "latitude": "20.00000000",
    "longitude": "77.00000000",
    "region": "Asia",
    "region_id": 3,
    "subregion": "Southern Asia",
    "subregion_id": 14,
    "timezones": "[{\"zoneName\":\"Asia/Kolkata\",\"gmtOffset\":19800,\"gmtOffsetName\":\"UTC+05:30\",\"abbreviation\":\"IST\",\"tzName\":\"Indian Standard Time\"}]",
    "population": 1380004385,
    "gdp": 2870504000000,
    "area_sq_km": 3287263,
    "postal_code_format": "######",
    "postal_code_regex": "^(\\d{6})$",
    "numeric_code": "356"
  }
]

{
  "error": "This feature is not available on your current plan.",
  "feature": "regionsApi",
  "upgradeUrl": "https://app.countrystatecity.in/pricing"
}

Tier-Based Field Availability

This endpoint requires Supporter+, so the Basic tier never applies. Returned country fields match Get Country Details:

Tier	Plans	Fields
Coordinates	Supporter	id, name, iso2, iso3, phonecode, capital, currency, currency_name, currency_symbol, tld, nationality, native, emoji, emojiU, latitude, longitude, region, region_id, subregion, subregion_id, timezones, numeric_code, population, gdp, area_sq_km, postal_code_format, postal_code_regex
Full	Professional, Business	All Coordinates + translations, wikiDataId

See Pricing for plan details.