Skip to main content
GET
/
v1
/
regions
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" }
]

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.

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 -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" }
]