# Country State City API

**Canonical:** https://apis.io/providers/country-state-city-api/  
**Website:** https://countrystatecity.in/  
**APIs profiled:** 3

The Country State City API is a global geographic reference dataset and REST API published by countrystatecity.in. It exposes 247+ countries, 5,000+ states / provinces, and 150,000+ cities with ISO 3166 codes, phone codes, capitals, currencies, native names, regions, sub-regions, coordinates, time zones, and flag emoji. The data is also distributed as downloadable JSON, SQL, PostgreSQL, SQLite, XML, YAML, and CSV bundles for offline use, and the live API is authenticated with the X-CSCAPI-KEY header from a free developer plan.

## Kin Score — 39.6 / 100 (developing)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 39.6).

| Facet | Score |
|---|---|
| Discoverability | 81.5 |
| Contract Quality | 54.5 |
| Governance | 60.6 |
| Contract Governance | 60.6 |
| Operational Transparency | 23.7 |
| Developer Ergonomics | 21.4 |
| Commercial Clarity | 15.8 |
| Access Clarity | 15.8 |

## Agent readiness — 34.7 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | na |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | na |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | na |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (3)

- **Country State City API Cities API** — City reference data with coordinates and time zones, scoped by country and state.
- **Country State City API Countries API** — Country reference data including ISO codes, currencies, phone codes, and regions.
- **Country State City API States API** — State, province, and region reference data scoped by country.

## Agentic access (1)

- **Country State City Api Agentic Access** — 9 operations

## Security (2)

- **Country State City Api Authentication** — apiKey · 1 scheme
- **Country State City Api Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Country State City Api Plans Pricing**

## Tags

Capitals, Cities, Countries, Currency, Geography, Geolocation, ISO 3166, JSON, Phone Codes, Provinces, Reference Data, Regions, States, Timezones

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/country-state-city-api/). Scores are computed from the provider's own public artifacts under a published rubric.