Country, State & City API

250 countries, 5,300 states and provinces and about 150,000 cities, with coordinates, time zones, currency, phone codes and more.

Quick start

curl "https://geo.quiply.net/v1/cities?country=US&state=CA&search=san" \
  -H "X-API-Key: YOUR_KEY"

Authentication

Every request must include your key in the X-API-Key header. You get your key instantly on the pricing section. Keep it secret — don't put it in public front-end code.

Base URL: https://geo.quiply.net

GET/v1/countries

List countries with ISO codes, capital, currency, phone code, region, population, coordinates and time zones.

GET/v1/countries/{code}

One country by ISO 2- or 3-letter code (JM or JAM), with state_count and city_count.

GET/v1/countries/{code}/states

All states, provinces or parishes of a country, with code, type, coordinates and time zone.

GET/v1/cities

Cities of a country, optionally of one state, in alphabetical order. Search is accent-insensitive and matches the start of the name.

{ "country": "US", "count": 1, "offset": 0,
  "cities": [ { "id": 125809, "name": "San Francisco", "state": "California", "state_code": "CA",
                 "country": "US", "latitude": 37.7749, "longitude": -122.4194, "timezone": "America/Los_Angeles" } ] }

GET/v1/search

Search countries, states and cities at once (q required, minimum 2 characters). Optional type (country, state or city) and limit 1–100.

GET/v1/health

Service status and dataset size. No key needed.

Errors

Pricing