Địa bàn hành chính (mã tỉnh, huyện, xã)
FreeKhoảng 15.600 đơn vị hành chính cấp tỉnh, huyện, xã gồm cả mã cũ đã hết hiệu lực và mã sau sắp xếp 2025 (34 tỉnh, ~3.300 xã; lọc is_active=true), kèm mã cũ được hợp nhất, lý do thay đổi, căn cứ. Nguồn: Danh mục dùng chung Bộ Tài chính (DM_DBHC).
Endpoint
| Endpoint | Mô tả |
|---|---|
| GET /v1/dmdc-administrative-units | Tìm kiếm, lọc, phân trang |
| GET /v1/dmdc-administrative-units/{id} | Chi tiết một bản ghi (toàn bộ trường) |
bash
curl "https://api.dulieuphapluat.vn/v1/dmdc-administrative-units?q=từ khoá&per_page=10" \
-H "Authorization: Bearer dlpl_live_xxxxxxxxxxxxxxxxxxxxxxxx"Tham số và trường dữ liệu
Tham số lọc
| Tham số | Kiểu |
|---|---|
| q | Từ khoá tìm trong: code, name |
| code | string |
| parent_code | string |
| province_code | string |
| level | string |
| is_active | bool |
| page, per_page | Phân trang |
Cần ít nhất một trong: q, code, parent_code, province_code, level
Trường dữ liệu
| Trường | Kiểu | Gói |
|---|---|---|
| id | id | Free |
| code | string | Free |
| name | string | Free |
| parent_code | string | Free |
| level | string | Free |
| province_code* | string | Free |
| district_code* | string | Free |
| merged_old_codes* | string | Free |
| change_reason* | string | Free |
| is_active | bool | Free |
| effective_from* | date_utc | Free |
| effective_to | date_utc | Free |
| document_date* | date_utc | Free |
| legal_basis* | string | Starter+ xem trước |
* chỉ trả ở endpoint chi tiết.