Loading
Loading
Retrieve administrative units (states, provinces, governorates) for any country. Filter by country code and pagination support.
Returns all administrative units for a country, optionally filtered by admin level.
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.
adminLevelsoptionalArrayComma-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 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.
This Country does not have any admin units associated with it.