Country State City API website screenshot

Country State City API

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.

1 APIs 0 Features
CapitalsCitiesCountriesCurrenciesGeographyGeolocationISO 3166JSONPhone CodesProvincesReference DataRegionsStatesTime Zones

APIs

Country State City API

REST API exposing world countries, states, regions, provinces, and cities with ISO2 / ISO3 codes, country code, phone code, capital, native language, time zones, latitude, longi...

Collections

Pricing Plans

Rate Limits

Country State City Api Rate Limits

5 limits

RATE LIMITS

FinOps

API Governance Rules

Country State City API API Rules

7 rules · 4 errors 3 warnings

SPECTRAL

Resources

🔗
Website
Website
🔗
Documentation
Documentation
🔗
APIIntroduction
APIIntroduction
🌐
Console
Console
💰
Pricing
Pricing
🔗
Downloads
Downloads
👥
GitHubRepository
GitHubRepository
🔗
Contact
Contact
📜
PrivacyPolicy
PrivacyPolicy
📜
TermsOfService
TermsOfService
🔗
Vocabulary
Vocabulary
🔗
LlmsText
LlmsText

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Country State City API
  version: '1.0'
request:
  auth:
    type: apikey
    key: X-CSCAPI-KEY
    value: '{{X-CSCAPI-KEY}}'
    placement: header
items:
- info:
    name: Countries
    type: folder
  items:
  - info:
      name: List all countries
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/countries
    docs: Returns the full list of countries with ISO2 / ISO3 codes, phone codes, capitals, native names, regions, currencies,
      and flag emoji.
  - info:
      name: Get a country by ISO2 code
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/countries/:ciso
      params:
      - name: ciso
        value: ''
        type: path
        description: ISO 3166-1 alpha-2 country code.
    docs: Get a country by ISO2 code
- info:
    name: States
    type: folder
  items:
  - info:
      name: List states for a country
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/countries/:ciso/states
      params:
      - name: ciso
        value: ''
        type: path
    docs: List states for a country
  - info:
      name: Get a state by country and state ISO codes
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/countries/:ciso/states/:siso
      params:
      - name: ciso
        value: ''
        type: path
      - name: siso
        value: ''
        type: path
    docs: Get a state by country and state ISO codes
  - info:
      name: List all states
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/states
    docs: List all states
- info:
    name: Cities
    type: folder
  items:
  - info:
      name: List cities in a country and state
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/countries/:ciso/states/:siso/cities
      params:
      - name: ciso
        value: ''
        type: path
      - name: siso
        value: ''
        type: path
    docs: List cities in a country and state
  - info:
      name: List cities for a country
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/countries/:ciso/cities
      params:
      - name: ciso
        value: ''
        type: path
    docs: List cities for a country
  - info:
      name: List cities for a state by numeric state id
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/states/:sid/cities
      params:
      - name: sid
        value: ''
        type: path
        description: Numeric state identifier.
    docs: List cities for a state by numeric state id
  - info:
      name: List all cities
      type: http
    http:
      method: GET
      url: https://api.countrystatecity.in/v1/cities
    docs: List all cities
bundled: true