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.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis 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.
An array of city objects for the specified country, optionally filtered by admin unit.
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status 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.