API — Vietnam (VN)
34 province/citys, 3,321 commune/wards.
Endpoints
GET
/api/v1/vn/province/{slug}.json
Single province/city with children
Example:
/api/v1/vn/province/ha-noi-01.json
Quick Start
JavaScript
fetch('https://openadmindata.org/api/v1/countries/vn.json')
.then(r => r.json())
.then(data => {
const levels = data.meta.levels.map(l => l.name_en);
console.log('Vietnam:', levels.join(' → '));
console.log(data.data.province.length, 'province/citys');
});Python
import requests
data = requests.get('https://openadmindata.org/api/v1/countries/vn.json').json()
provinces = data['data']['province']
print(f"Vietnam: {len(provinces)} province/citys")cURL
curl -s https://openadmindata.org/api/v1/vn/province.json | jq '.count'Schema
Each entity record contains:
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier |
name_local | string | Name in local script |
name_en | string | English / romanized name |
slug | string | URL-safe slug |
lat | number | Latitude (WGS84) |
lon | number | Longitude (WGS84) |
parent_id | string? | Parent entity ID (null for top level) |
parent_name_local | string? | Parent name in local script |
parent_name_en | string? | Parent English name |
postal_code | string? | Postal code (deepest level only, where available) |