Loading
Loading
Retrieve administrative level hierarchy for a country. Understand how countries are divided into states, provinces, districts, and sub-districts.
Returns the distinct administrative level types (e.g., province, district) for a given country.
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 parameter is required.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
countryrequiredStringCountry code in ISO 3166-1 alpha-2 format
A successful request returns a 200 OK response with an array of admin level names.
admin_levelsAn array of unique administrative level types defined for the specified country. Each value represents a category of administrative division, such as "state", "district", "outlying area", or other country-specific administrative regions.
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.
This Country does not have any admin units associated with it.