Admin Regions

Administrative regions by country and level.

GET

Parameters

Parameter	Type	Required	Description
`country`	string	Required	ISO2 country code
`level`	integer	Optional	Admin level: 1=states/provinces, 2=counties/districts

Request Example

curl "https://api.localityapi.com/v1/admin?country=AE&level=1" \
  -H "X-API-Key: lapi_your_key"

Response

json

{
  "results": [
    {"name": "Abu Dhabi", "code": "AZ", "level": 1},
    {"name": "Dubai", "code": "DU", "level": 1},
    {"name": "Sharjah", "code": "SH", "level": 1},
    {"name": "Ajman", "code": "AJ", "level": 1},
    {"name": "Fujairah", "code": "FU", "level": 1},
    {"name": "Ras al-Khaimah", "code": "RK", "level": 1},
    {"name": "Umm al-Quwain", "code": "UQ", "level": 1}
  ],
  "country": "AE",
  "count": 7,
  "query_ms": 3
}

Response Fields

resultsarrayArray of admin regions

results[].namestringRegion name

results[].codestringRegion code

results[].levelintegerAdmin level

countrystringCountry code

countintegerNumber of regions

query_msintegerQuery execution time in milliseconds