SearchCtrl+K

GeoDB APIs›Admin Levels API

Admin Levels API Reference

Retrieve administrative level hierarchy for a country. Understand how countries are divided into states, provinces, districts, and sub-districts.

GET

https://api.apifreaks.com/v1.0/geo/admin-levels

Test

Returns the distinct administrative level types (e.g., province, district) for a given country.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/geo/admin-levels?country=PK' \
  -H 'X-apiKey: API-KEY'

Response

{
  "admin_levels": [
    "province",
    "federal capital territory",
    "administered area"
  ]
}

API Request

Query Parameters

The following parameter is required.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

countryrequiredString

Country code in ISO 3166-1 alpha-2 format

API Response Schema

A successful request returns a 200 OK response with an array of admin level names.

admin_levels

Array<String>mandatory

An 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.

Error Status & Codes

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.

400

Only ISO 3166-1 alpha-2 codes country codes are supported.

404

This Country does not have any admin units associated with it.