administrative-divisons-db

API

Free API for accessing hierarchical administrative division data of countries

Overview

The administrative-divisons-db API offers RESTful access to structured administrative division data (states, provinces, districts, etc.) for multiple countries. Key endpoints include GET /countries/{iso_code}/divisions to retrieve all divisions for a country (using ISO 3166 codes) and GET /countries/{iso_code}/divisions/{level} to filter by division hierarchy level. Responses are in JSON format, simplifying integration. Use cases include building location picker forms, enhancing geocoding services with regional data, and supporting geographic data analysis projects.

Example Integration (JavaScript)

script.js JS


fetch('https://github.com/kamikazechaser/administrative-divisions-db')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Key Features

RESTful API
JSON response format
No authentication required
Multi-country support
Hierarchical division data

Frequently Asked Questions

? Is administrative-divisons-db free to use?

Yes, it is completely free and open source with no hidden costs or subscription fees.

? Does it require an API Key?

No, the API does not require any authentication or API key to access its endpoints.

? What is the response format?

All responses are returned in JSON format, which is widely compatible with most programming languages and applications.

Top Alternatives

GeoNames API Search Google

OpenStreetMap Nominatim Search Google

Tool Info

Pricing Free

Category Geocoding

Platform Public API

Pros

⊕ Free and open source
⊕ Easy to integrate
⊕ Comprehensive regional data
⊕ No API key needed

Cons

⊖ Rate limits for high-volume requests
⊖ No official SLA
⊖ Data updates depend on community contributions