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);
[
{
"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"
}
Regions Endpoints
Get Countries by Subregion
Retrieve countries belonging to a specific subregion
GET
/
v1
/
subregions
/
{id}
/
countries
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);
[
{
"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.
See Pricing for plan details.
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
Your API key for authentication
Path Parameters
Numeric subregion ID (e.g.,
14 for Southern Asia)Query Parameters
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 -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);
[
{
"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 |
Was this page helpful?
⌘I