Loading
Loading
Retrieve a list of cities with pagination, filtering by country or region. Includes city name, coordinates, timezone, and population data.
Returns all cities for a given country, optionally filtered by administrative unit.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests.
countryrequiredStringCountry code in ISO 3166-1 alpha-2 format.
admin_unitoptionalStringAdministrative unit code used to filter cities within a specific region.
A successful request returns a 200 OK response with an array of city objects.
citiesAn array of city objects for the specified country, optionally filtered by admin unit.
cities[].nameThe name of the city (e.g., "Karachi", "Mirpur").
cities[].latitudeThe geographic latitude of the city in decimal degrees.
cities[].longitudeThe geographic longitude of the city in decimal degrees.
cities[].iso_alpha_2The ISO 3166-1 alpha-2 country code the city belongs to (e.g., "PK").
cities[].admin_unitAn object describing the administrative unit the city belongs to.
cities[].admin_unit.nameThe full name of the administrative unit (e.g., "Azad Kashmir").
cities[].admin_unit.admin_codeThe short code of the administrative unit (e.g., "JK").
cities[].admin_unit.admin_levelThe administrative level type of the unit (e.g., "province", "administered area").
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Only ISO 3166-1 alpha-2 codes country codes are supported.
Please provide a valid admin code.
This Country does not have any admin units associated with it.