ISO 3166 Country Subdivisions API
The ISO 3166-2 Subdivisions API provides structured access to the complete ISO 3166-2 standard — the international norm defining codes for the principal administrative divisions of all countries recognized under ISO 3166-1. From Italian regions and German Bundesländer to US states, Brazilian estados, and Japanese prefectures — every country's administrative geography is covered in a single,…
ISO 3166 Country Subdivisions API endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
List Subdivisions (Filtered & Paginated) / |
Returns a paginated list of ISO 3166-2 subdivisions across all countries. Supports filtering by country code, subdivision type, and name keyword. Useful for bulk exports, seeding… |
| GET |
Get All Subdivisions for a Country /country/{country_code} |
Returns all administrative subdivisions of a given country, identified by its ISO 3166-1 alpha-2 code. Optionally filter by subdivision type to retrieve only regions, provinces,… |
| GET |
Get Subdivision by ISO 3166-2 Code /subdivision/{subdivision_code} |
Returns the full record for a specific administrative subdivision identified by its ISO 3166-2 code. Lookup is exact-match and case-insensitive. Use for validation, data… |
| GET |
List All Subdivision Types /types |
Returns all distinct subdivision types present in the dataset, ranked by frequency (descending). Use to populate dynamic filter dropdowns or understand the distribution of… |
| GET |
List Available Countries /countries |
Returns all countries present in the dataset with the count of their subdivisions. Sorted alphabetically by ISO 3166-1 alpha-2 code. Use to populate country selectors, validate… |
ISO 3166 Country Subdivisions API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $9 / month | — |
|
| ULTRA | $19 / month | — |
|
| MEGA | $45 / month | — |
|