> ## 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 All Regions

> Retrieve a list of geographic regions

Retrieve all geographic regions (Africa, Americas, Asia, Europe, Oceania, Polar). Supports optional search filtering.

<Note>**Availability:** Supporter plan and above. Returns `403` on lower tiers.</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>

## Query Parameters

<ParamField query="q" type="string">
  Search filter on region name. Case-insensitive, minimum 2 characters. Requires Supporter+ plan.
</ParamField>

## Response

<ResponseField name="id" type="integer">
  Unique identifier for the region
</ResponseField>

<ResponseField name="name" type="string">
  Region name (e.g., Asia, Europe)
</ResponseField>

<ResponseField name="translations" type="string">
  JSON string of translations in 18+ languages. **Full access level only.**
</ResponseField>

<ResponseField name="wikiDataId" type="string">
  Wikidata item identifier. **Coordinates tier and above.**
</ResponseField>

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

  ```bash cURL (with search) theme={null}
  curl -X GET 'https://api.countrystatecity.in/v1/regions?q=asia' \
    -H 'X-CSCAPI-KEY: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.countrystatecity.in/v1/regions', {
    headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
  });

  const regions = await response.json();
  console.log(regions);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
    'https://api.countrystatecity.in/v1/regions',
    headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
  )

  regions = response.json()
  print(regions)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  [
    { "id": 1, "name": "Africa" },
    { "id": 2, "name": "Americas" },
    { "id": 3, "name": "Asia" },
    { "id": 4, "name": "Europe" },
    { "id": 5, "name": "Oceania" },
    { "id": 6, "name": "Polar" }
  ]
  ```

  ```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>

## Related Endpoints

* [Get Subregions of a Region](/api/endpoints/get-subregions-by-region) — drill down into subregions
* [Get Countries in a Subregion](/api/endpoints/get-countries-by-subregion) — countries within a subregion