Loading
Loading
Retrieve all cities for a given country with latitude, longitude, administrative unit details, and ISO country codes. Optionally filter by administrative unit.
Returns all cities for a country, optionally filtered by administrative unit using the admin_unit parameter.
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.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
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 details about supported status codes and error responses, refer to the HTTP Error Codes.
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.