> ## 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.

# Get Countries by Subregion

> Retrieve countries belonging to a specific subregion

Retrieve all countries within a subregion. For example, subregion "Southern Asia" contains India, Pakistan, Bangladesh, etc.

<Note>**Availability:** Supporter plan and above.</Note>

<Tip>
  **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](/api/field-filtering-and-sorting) guide for syntax and per-entity sortable fields.
</Tip>

## Authentication

<ParamField header="X-CSCAPI-KEY" type="string" required>
  Your API key for authentication
</ParamField>

## Path Parameters

<ParamField path="id" type="integer" required>
  Numeric subregion ID (e.g., `14` for Southern Asia)
</ParamField>

## Query Parameters

<ParamField query="q" type="string">
  Search filter on country name. Min 2 characters. Requires Supporter+ plan.
</ParamField>

## Response

Returns the same country object as [Get All Countries](/api/endpoints/get-all-countries), filtered to the subregion.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://api.countrystatecity.in/v1/subregions/14/countries' \
    -H 'X-CSCAPI-KEY: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  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);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Supporter tier (Coordinates) — abridged theme={null}
  [
    {
      "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"
    }
  ]
  ```

  ```json 403 - Feature Restricted theme={null}
  {
    "error": "This feature is not available on your current plan.",
    "feature": "regionsApi",
    "upgradeUrl": "https://app.countrystatecity.in/pricing"
  }
  ```
</ResponseExample>

## Tier-Based Field Availability

This endpoint requires **Supporter+**, so the **Basic** tier never applies. Returned country fields match [Get Country Details](/api/endpoints/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](https://app.countrystatecity.in/pricing) for plan details.
