Loading
Loading
Retrieve administrative units — states, provinces, governorates — for any country using ISO 3166-1 alpha-2 country codes. Supports optional filtering by one or more admin levels.
Returns all administrative units for a country, optionally filtered by admin level using the adminLevels 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_leveloptionalStringComma-separated list to filter results by one or more administrative levels.
A successful request returns a 200 OK response with an array of admin unit objects.
admin_unitsAn array of administrative unit objects for the specified country, optionally filtered by admin level.
admin_units[].nameThe full name of the administrative unit (e.g., "Punjab", "Azad Kashmir").
admin_units[].admin_codeThe short code identifying the administrative unit (e.g., "PB", "JK").
admin_units[].admin_levelThe type/level of the administrative unit (e.g., "province", "administered area", "federal capital territory").
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.
This Country does not have any admin units associated with it.