Skip to main content
Retrieve all geographic regions (Africa, Americas, Asia, Europe, Oceania, Polar). Supports optional search filtering.
Availability: Supporter plan and above. Returns 403 on lower tiers.

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 -X GET 'https://api.countrystatecity.in/v1/regions' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'
[
  { "id": 1, "name": "Africa" },
  { "id": 2, "name": "Americas" },
  { "id": 3, "name": "Asia" },
  { "id": 4, "name": "Europe" },
  { "id": 5, "name": "Oceania" },
  { "id": 6, "name": "Polar" }
]