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",
"phonecode": "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
- Exact postcode lookup, city classification, and data version metadata
- Basic fields only (no translations or premium data)
- Open access (no origin whitelisting)
- Community support and docs
Starter
More headroom for side projects and prototypes.
- 9,000 API Requests/month (300/day)
- Same features as Community with higher limits
- All bulk states and cities by country endpoints
- Postcode listing and search with cursor pagination
- Inline search filtering, regions, phone, and currency lookup APIs
- Field filtering (?fields=) on every geographic endpoint; custom sort (?sort=) on list endpoints
- Basic fields only (no translations or premium data)
- Community support and docs
Supporter
Ideal for growing applications with enhanced data.
- 30,000 API Requests/month (1,000/day)
- All Starter features
- Extended country and state fields + city coordinates, localized names, translations, and wiki data
- Fuzzy / typo-tolerant search (GET /v1/search/fuzzy)
- Location autocomplete with ranked, labeled suggestions (GET /v1/search/autocomplete)
- Find places near a location, ranked by distance (GET /v1/search/nearby)
- Origin whitelisting (up to 3 domains or IPs)
- Founder-led email support (2-3 business days)
Professional
GraphQL, the data change feed and higher limits for production apps.
- 63,000 API Requests/month (2,100/day)
- All Supporter features
- Data change feed for syncing a local copy (GET /v1/changes)
- Origin whitelisting (up to 10 domains or IPs)
- Founder-led priority support (~1 business day)
- GraphQL API (POST /v1/graphql)
Business
The most headroom and every premium feature.
- 100,000 API Requests/month (3,300/day)
- All Professional features
- Origin whitelisting (up to 25 domains or IPs)
- Founder-led priority support (~1 business day)
- All current and upcoming premium features
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 | $19/mo | $29/mo |
| Annual price | Free | $50/yr | $90/yr | $190/yr | $290/yr |
| Monthly Requests | 3,000 | 9,000 | 30,000 | 63,000 | 100,000 |
| Daily Requests | 100 | 300 | 1,000 | 2,100 | 3,300 |
| 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 | |||||
| Postcode Listing & Search | |||||
| 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 | |||||
| Location Autocomplete | |||||
| GraphQL API | |||||
| Nearby / Geospatial Search | |||||
| Data Change Feed | |||||
| 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.