Country State City API

aid: country-state-city-api
name: Country State City API
kind: company
description: 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.
url: https://raw.githubusercontent.com/api-evangelist/country-state-city-api/refs/heads/main/apis.yml
deliveryModel:
  model: saas
  license: ODbL-1.0
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - license
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
image: https://kinlane-productions2.s3.amazonaws.com/apis-json-icons/country-state-city-api.png
type: Index
access: Public
position: Producing
x-docs-platform: mintlify
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-09-24
tags:
- Capital
- Cities
- Countries
- Currency
- Geography
- Geolocation
- ISO 3166
- JSON
- Phone Codes
- Provinces
- Reference Data
- Regions
- States
- Timezone
tags_raw:
- Capitals
- Cities
- Countries
- Currencies
- Geography
- Geolocation
- ISO 3166
- JSON
- Phone Codes
- Provinces
- Reference Data
- Regions
- States
- Time Zones
created: '2024-03-30'
modified: '2026-10-06'
specificationVersion: '0.23'
apis:
- aid: country-state-city-api:country-state-city-api-cities-api
  name: Country State City API Cities API
  description: City reference data with coordinates and time zones, scoped by country and state.
  humanURL: https://docs.countrystatecity.in/
  baseURL: https://api.countrystatecity.in/v1
  tags:
  - Cities
  properties:
  - type: OpenAPI
    url: openapi/country-state-city-api-cities-api-openapi.yml
  - type: Documentation
    url: https://docs.countrystatecity.in/
  - type: APIIntroduction
    url: https://docs.countrystatecity.in/api/introduction
  - type: Signup
    url: https://app.countrystatecity.in/
  - type: Rules
    url: rules/country-state-city-api-rules.yml
- aid: country-state-city-api:country-state-city-api-countries-api
  name: Country State City API Countries API
  description: Country reference data including ISO codes, currencies, phone codes, and regions.
  humanURL: https://docs.countrystatecity.in/
  baseURL: https://api.countrystatecity.in/v1
  tags:
  - Countries
  properties:
  - type: OpenAPI
    url: openapi/country-state-city-api-countries-api-openapi.yml
  - type: Documentation
    url: https://docs.countrystatecity.in/
  - type: APIIntroduction
    url: https://docs.countrystatecity.in/api/introduction
  - type: Signup
    url: https://app.countrystatecity.in/
  - type: Rules
    url: rules/country-state-city-api-rules.yml
- aid: country-state-city-api:country-state-city-api-states-api
  name: Country State City API States API
  description: State, province, and region reference data scoped by country.
  humanURL: https://docs.countrystatecity.in/
  baseURL: https://api.countrystatecity.in/v1
  tags:
  - States
  properties:
  - type: OpenAPI
    url: openapi/country-state-city-api-states-api-openapi.yml
  - type: Documentation
    url: https://docs.countrystatecity.in/
  - type: APIIntroduction
    url: https://docs.countrystatecity.in/api/introduction
  - type: Signup
    url: https://app.countrystatecity.in/
  - type: Rules
    url: rules/country-state-city-api-rules.yml
common:
- type: Plans
  url: plans/country-state-city-api-plans-pricing.yml
- type: RateLimits
  url: rate-limits/country-state-city-api-rate-limits.yml
- type: FinOps
  url: finops/country-state-city-api-finops.yml
- url: https://countrystatecity.in/blog/
  type: Blog
- type: IssueTracker
  url: https://github.com/dr5hn/countries-states-cities-database/issues
- type: Releases
  url: https://github.com/dr5hn/countries-states-cities-database/releases
- type: CodeOfConduct
  url: https://github.com/dr5hn/countries-states-cities-database/blob/master/.github/CODE_OF_CONDUCT.md
- type: ContributionGuide
  url: https://github.com/dr5hn/countries-states-cities-database/blob/master/.github/CONTRIBUTING.md
- type: License
  name: ODbL-1.0
  url: https://github.com/dr5hn/countries-states-cities-database/blob/master/LICENSE
- type: AgenticAccess
  url: agentic-access/country-state-city-api-agentic-access.yml
- type: DomainSecurity
  url: security/country-state-city-api-domain-security.yml
- type: Authentication
  url: authentication/country-state-city-api-authentication.yml
- type: Website
  url: https://countrystatecity.in/
- type: Documentation
  url: https://docs.countrystatecity.in/
- type: APIIntroduction
  url: https://docs.countrystatecity.in/api/introduction
- type: Console
  url: https://app.countrystatecity.in/
- type: Pricing
  url: https://countrystatecity.in/pricing/
- type: Downloads
  url: https://countrystatecity.in/downloads/
- type: GitHubRepository
  url: https://github.com/dr5hn/countries-states-cities-database
- type: Contact
  url: https://countrystatecity.in/contact/
- type: PrivacyPolicy
  url: https://countrystatecity.in/privacy-policy/
- type: TermsOfService
  url: https://countrystatecity.in/terms/
- type: Vocabulary
  url: vocabulary/country-state-city-api-vocabulary.yml
- type: Integrations
  url: https://countrystatecity.in/integrations
- type: LlmsText
  url: https://docs.countrystatecity.in/llms.txt
integrations:
- name: Hk
- name: Raj Maurya
- name: Zahid Farooq
- name: The ICT Hub
- name: Sumit Sahni
- name: Kent Noetico
- name: Johnson Mercy
- name: Ed Seffrin
- name: Elias Sanchez
- name: Shreyash Shinde
- name: Adesoji Adesesan
- name: Mohamed Elsayed
- name: Edwin Gah
- name: Oluwadamilola Samuel
- name: Tyke
- name: Ashok GV
- name: Danu Rahadi
- name: Juvance FITAHIANJANAHARY
- name: Andry Razafinjatovo
- name: Sagar Sonara
- name: Rohit Singh
- name: Muniraj M
- name: Vinay P
- name: Tini NK
- name: Daniel Jaramillo
- name: Larson Jaide
- name: Zakiullah Khan
- name: Vishal Shah
- name: Victory Onorhime
- name: Amal K Jose
- name: Nikhil Kamboj
- name: Mahmudul Hasan Sagar
- name: Siril Pappula
- name: Cedric Borreguín
- name: Brendan
- name: Ameer Hamza
- name: Johan Walhout
- name: Akash
- name: Hiren Chauhan
- name: BRANDON LAKINYU
- name: Sonu Kumar
- name: Atul j
- name: Mike Lettona
- name: Manish Raj
- name: Kailash G
- name: Mo Kakwan
- name: Hanish Rao
- name: Grace Frank
- name: Vishal Rana
- name: Tushar Agarwal
- name: Akshay Rai Priyadarshi
- name: Shahzaib Minhas
- name: Bendicht Eggimann
- name: Bodnariu Daniel-Iustin
- name: Magio
- name: Coding Psycho
- name: Douglas Huertas
- name: Jesus David Santiago Jarava
- name: Shivam
- name: Gabriel Rajendran
- name: Muhammed Balta
- name: souren
- name: gurjari
- name: Omair
- name: Jamtech Pvt. Ltd.
- name: Perekpo Paulinus Emmanuel
- name: bhaskar sengupta
- name: Onur Gösteriş
- name: Gabriel
- name: Amol Shah
- name: Sabit bin hamid
- name: Carlos Arenas
- name: Guille Acosta
- name: Thiago Oliveira
- name: Elias Mamo
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com