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)
[
{ "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"
}
Regions Endpoints
Get All Regions
Retrieve a list of geographic regions
GET
/
v1
/
regions
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)
[
{ "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
Your API key for authentication
Query Parameters
Search filter on region name. Case-insensitive, minimum 2 characters. Requires Supporter+ plan.
Response
Unique identifier for the region
Region name (e.g., Asia, Europe)
JSON string of translations in 18+ languages. Full access level only.
Wikidata item identifier. Coordinates tier and above.
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)
[
{ "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
Was this page helpful?
⌘I