Get All Regions

Retrieve a list of geographic regions

GET /v1/regions

cURL

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

curl -X GET 'https://api.countrystatecity.in/v1/regions?q=asia' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

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);

import requests

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

regions = response.json()
print(regions)

200 - Success

[
  { "id": 1, "name": "Africa" },
  { "id": 2, "name": "Americas" },
  { "id": 3, "name": "Asia" },
  { "id": 4, "name": "Europe" },
  { "id": 5, "name": "Oceania" },
  { "id": 6, "name": "Polar" }
]

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

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

Availability: Supporter plan and above. Returns 403 on lower tiers.

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

Query Parameters

q · string

Search filter on region name. Case-insensitive, minimum 2 characters. Requires Supporter+ plan.

Response

id · integer

Unique identifier for the region

name · string

Region name (e.g., Asia, Europe)

translations · string

JSON string of translations in 18+ languages. Full access level only.

wikiDataId · string

Wikidata item identifier. Coordinates tier and above.

cURL

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

curl -X GET 'https://api.countrystatecity.in/v1/regions?q=asia' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

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);

import requests

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

regions = response.json()
print(regions)

200 - Success

[
  { "id": 1, "name": "Africa" },
  { "id": 2, "name": "Americas" },
  { "id": 3, "name": "Asia" },
  { "id": 4, "name": "Europe" },
  { "id": 5, "name": "Oceania" },
  { "id": 6, "name": "Polar" }
]

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

Related Endpoints

• Get Subregions of a Region — drill down into subregions
• Get Countries in a Subregion — countries within a subregion