Enterprise-Grade
Geographical API
Power your applications with the world's most comprehensive geographical data API. Trusted by thousands of developers, handling 5.1B+ total requests with 99.9% uptime.
{
"id": 101,
"name": "India",
"iso2": "IN",
"capital": "New Delhi",
"currency": "INR",
"phone_code": "91",
"emoji": "🇮🇳"
}Why Choose Our API?
Built for scale, designed for developers, trusted by enterprises worldwide
Lightning Fast Response
Average response time under 200ms globally.
Shape Your Response
?fields= trims responses to only the columns you need. ?sort= orders list results server-side. Pay for the data you use, not what you discard.
DST-Aware Timezones
Resolve any country, state, or city to its canonical IANA timezone with current DST state, standard offset, and daylight offset in one call.
Phone & ISO Helpers
Parse E.164 numbers into country + national parts, look up dial codes, and convert ISO 3166 codes between alpha-2, alpha-3, and numeric formats.
Typo-Tolerant Search
Fuzzy search resolves misspellings, transliterations, and native-script queries — 'Banglore' finds Bangalore — with a confidence score on every match.
Always Up-to-Date
Regular data updates with automated sync processes ensuring you always have the latest geographical information.
Developer-Friendly
RESTful design, comprehensive documentation, code examples, and SDKs for popular programming languages.
Easy Integration
Get started in minutes with our simple RESTful API.
// Get all countries
fetch('https://api.countrystatecity.in/v1/countries', {
headers: {
'X-CSCAPI-KEY': 'your-api-key'
}
})
.then(response => response.json())
.then(countries => {
console.log(countries);
});
// Get states in a country
fetch('https://api.countrystatecity.in/v1/countries/IN/states', {
headers: {
'X-CSCAPI-KEY': 'your-api-key'
}
})
.then(response => response.json())
.then(states => {
console.log(states);
});Simple, Transparent API Pricing
Start for free and scale as your application grows. No hidden fees, no surprises.
Community
Perfect for personal projects & exploration.
- 3,000 API Requests/month (100/day)
- States by country and cities by state endpoints
- Basic fields: name, iso codes, capital, currency, region, emoji, lat/lng, timezones
- Timezone lookup endpoints (country, state, city) with DST awareness
- Open access (no domain whitelisting)
- Community support & documentation
Starter
More headroom for side projects and prototypes.
- 9,000 API Requests/month (300/day)
- Same features as Community with higher limits
- Basic fields: name, iso codes, capital, currency, region, emoji, lat/lng, timezones
- ISO 3166 lookup endpoints (alpha-2, alpha-3, numeric, subdivision conversion)
- Open access (no domain whitelisting)
- Community support & documentation
Supporter
Ideal for growing applications with enhanced data.
- 30,000 API Requests/month (1,000/day)
- Extended fields: population, GDP, area, TLD, nationality, postal codes, coordinates
- Inline search filtering on all list endpoints
- Regions, subregions, ISO, phone dial code, and timezone APIs
- Field filtering (?fields=) and custom sort (?sort=) on every geographic endpoint
- Cities by country endpoint
- Domain whitelisting (up to 3 domains)
- Founder-led email support (2-3 business days)
Professional
Full data access for production applications.
- 100,000 API Requests/month (3,300/day)
- Full field access including translations & wiki data
- All endpoints including cities by country
- Regions, subregions, ISO, phone dial code, and timezone APIs
- Field filtering (?fields=) and custom sort (?sort=) on every geographic endpoint
- Fuzzy / typo-tolerant search across cities, states & countries
- Domain + IP whitelisting (up to 10)
- Founder-led priority support (~1 business day)
- Coming soon: GraphQL, geospatial search
Business
High-volume access with all premium features.
- 750,000 API Requests/month (25,000/day)
- Full field access including translations & wiki data
- All current and upcoming premium features
- Domain + IP whitelisting (up to 25)
- Founder-led priority support (~1 business day)
Need higher limits or custom features?
We offer tailored plans with negotiated limits, custom data access levels, and dedicated support.
Compare all features
Every tier, side by side. Pick the plan that matches the data and endpoints you need.
| Feature | Community | Starter | SupporterMost Popular | Professional | Business |
|---|---|---|---|---|---|
| Pricing & Limits | |||||
| Price | Free | $5/mo | $9/mo | $29/mo | $79/mo |
| Monthly Requests | 3,000 | 9,000 | 30,000 | 100,000 | 750,000 |
| Daily Requests | 100 | 300 | 1,000 | 3,300 | 25,000 |
| Origin Whitelisting | Up to 3 | Up to 10 | Up to 25 | ||
| Country Fields | |||||
| Core fields (name, iso2/3, phone, capital, currency, emoji, lat/lng, region, timezones) | |||||
| Extended fields (numeric code, currency name/symbol, TLD, nationality, population, GDP, area, postal code) | |||||
| Translations & Wiki Data | |||||
| State Fields | |||||
| Core fields (name, iso2, country code, lat/lng, timezone) | |||||
| Extended fields (FIPS code, ISO 3166-2, type, level, parent, native name, population) | |||||
| Translations & Wiki Data | |||||
| City Fields | |||||
| Core fields (name) | |||||
| Extended fields (state/country code, lat/lng, timezone, population, type, level, parent, native name) | |||||
| Translations & Wiki Data | |||||
| Endpoints & Features | |||||
| REST API | |||||
| All Countries | |||||
| States by Country | |||||
| All States (Global) | |||||
| Cities by State | |||||
| Cities by Country | |||||
| Inline Search Filtering | |||||
| Regions & Subregions API | |||||
| Phone Dial Code Lookup | |||||
| Currency Lookup by Country | |||||
| ISO Code Lookup | |||||
| Timezone Lookup (country/state/city) | |||||
| Fields Filtering (?fields=) | |||||
| Sorting (?sort=) | |||||
| Fuzzy / Typo-Tolerant Search | |||||
| GraphQL API | Coming soon | Coming soon | |||
| Nearby / Geospatial Search | Coming soon | Coming soon | |||
| Support | |||||
| Support Level | Community & Docs | Community & Docs | Founder-led email (2-3 business days) | Priority (~1 business day) | Priority (~1 business day) |
Ready to Build Something Amazing?
Join thousands of developers using our platform to power location-based features. Start building today with our generous free tier and scale as you grow.