Open dataset of Laos' administrative hierarchy — from provinces (ແຂວງ) through districts (ເມືອງ) down to villages (ບ້ານ). This repository provides structured, bilingual (Lao + English) reference data for all three levels of Lao administrative divisions, including geographic coordinates at every level. Designed for developers, researchers, government agencies, and AI agents.
Licensed under CC-BY-4.0. Browse the hierarchy through GitHub's folder navigation, download aggregate files in JSON/CSV/NDJSON, or integrate directly via raw URLs.
| Item | Details |
|---|---|
| Province | 18 |
| District | 148 |
| Village | 13,330 |
| Coordinates | ✅ Included (all levels) |
| Formats | JSON, NDJSON, CSV |
| License | CC-BY-4.0 |
| Last Updated | 2026-05-16 |
| # | Province | Districts | Villages | Link |
|---|---|---|---|---|
| 1 | ແຂວງອັດຕະປື (Attapeu) | 4 | 213 | Browse |
| 2 | ແຂວງບໍ່ແກ້ວ (Bokeo) | 5 | 345 | Browse |
| 3 | ແຂວງບໍລິຄຳໄຊ (Bolikhamsai) | 7 | 487 | Browse |
| 4 | ແຂວງຈຳປາສັກ (Champasak) | 11 | 1,068 | Browse |
| 5 | ແຂວງຫົວພັນ (Houaphan) | 9 | 1,003 | Browse |
| 6 | ແຂວງຄຳມ່ວນ (Khammouane) | 9 | 778 | Browse |
| 7 | ແຂວງຫຼວງນ້ຳທາ (Luang Namtha) | 5 | 465 | Browse |
| 8 | ແຂວງຫລວງພະບາງ (Luang Prabang) | 11 | 1,373 | Browse |
| 9 | ແຂວງອຸດົມໄຊ (Oudomxay) | 7 | 889 | Browse |
| 10 | ແຂວງຜົ້ງສາລີ (Phongsaly) | 7 | 794 | Browse |
| 11 | ແຂວງສາລະວັນ (Salavan) | 8 | 776 | Browse |
| 12 | ແຂວງສະຫວັນນະເຂດ (Savannakhet) | 16 | 1,634 | Browse |
| 13 | ແຂວງວຽງຈັນ (Vientiane Province) | 11 | 597 | Browse |
| 14 | ນະຄອນຫຼວງວຽງຈັນ (Vientiane Capital) | 9 | 334 | Browse |
| 15 | ແຂວງໄຊຍະບູລີ (Xaignabouli) | 11 | 610 | Browse |
| 16 | ແຂວງເຊກອງ (Xekong) | 4 | 386 | Browse |
| 17 | ແຂວງຊຽງຂວາງ (Xiangkhouang) | 9 | 1,384 | Browse |
| 18 | ເຂດພິເສດໄຊສົມບູນ (Xaisomboun) | 5 | 194 | Browse |
| File | Format | Description |
|---|---|---|
| all-province.json | JSON | All 18 province records |
| all-district.json | JSON | All 148 district records |
| village-by-province/ | JSON | 13,330 villages split by province |
| all-flat.json | JSON | Levels 1-2 flat array |
| all-flat.ndjson | NDJSON | Streaming format |
| all-flat.csv | CSV | Spreadsheet format |
| hierarchy.json | JSON | Nested tree |
| schema.json | JSON Schema | Data schema |
import json
with open("data/all-province.json", "r", encoding="utf-8") as f:
data = json.load(f)
for r in data:
print(f"{r['name']['local']} ({r['name']['en']}) — {r['children_count']['district']} districts")import { readFileSync } from "fs";
const data = JSON.parse(readFileSync("data/all-province.json", "utf-8"));
console.log(`Total: ${data.length} provinces`);| Field | Type | Description |
|---|---|---|
id |
string | Unique identifier |
level |
integer | 1=province, 2=district, 3=village |
level_name |
object | Level label (local + English) |
name.local |
string | Name in local script |
name.en |
string | English name |
name.slug |
string | URL-safe slug |
parent |
object/null | Parent division reference |
ancestors |
array | Full ancestor chain |
children_count |
object | Count of children per level |
zip_codes |
array | Postal codes (where available) |
geo.lat |
string | Latitude (WGS84) |
geo.lon |
string | Longitude (WGS84) |
Full schema: data/schema.json
divisions/{province-slug}/
divisions/{province-slug}/{district-slug}/
Villages are listed inline in each district's README.
- llms.txt — Quick reference for AI agents
- llms-full.txt — Summary with per-province links
- Per-province data — Full data by province
Laos Administrative Divisions Dataset (CC-BY-4.0)
URL: https://github.com/open-admin-data/laos-administrative-divisions
See CITATION.cff for machine-readable citation.
- Data: CC-BY-4.0
- ListBase — Structured reference data for every country
- open-admin-data — Open administrative data for ASEAN countries
- thailand-administrative-divisions — Thailand dataset