Countries, regions and cities in one predictable JSON structure.
Current dataset coverage
Coverage varies by country and region.
Move from a country to its regions, then to its cities, with predictable endpoints and relationships that stay intact.
Make your first request in seconds. No guesswork and no tangled data model.
curl https://fetch.countrystateapi.com/locations/countries{
"success": true,
"countries": [
{ "code": "US", "name": "United States" },
{ "code": "IN", "name": "India" }
]
}/locations/countriesList every supported country/locations/states/:countryCodeGet regions for a country/locations/cities/:countryCode/:stateNameGet cities for a regionClear facts about the product, current coverage and developer use cases.
Country State API provides structured country, region and city reference data for software applications.
The current dataset contains 108 countries, 1,832 states, provinces or regions, and 24,760 city and town records.
Developers can power registration forms, address forms, customer profiles, booking systems, ecommerce experiences and geographic selectors.
The API returns predictable JSON responses designed for web, mobile and business applications.