Skip to main content
GET
/
v1
/
subregions
/
{id}
/
countries
curl -X GET 'https://api.countrystatecity.in/v1/subregions/14/countries' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

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

Documentation Index

Fetch the complete documentation index at: https://docs.countrystatecity.in/llms.txt

Use this file to discover all available pages before exploring further.

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 -X GET 'https://api.countrystatecity.in/v1/subregions/14/countries' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

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

​
Tier-Based Field Availability

This endpoint requires Supporter+, so the Basic tier never applies. Returned country fields match Get Country Details:
TierPlansFields
CoordinatesSupporterid, 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
FullProfessional, BusinessAll Coordinates + translations, wikiDataId
See Pricing for plan details.