VUIZ API Documentation

Tài liệu API Dữ liệu Hành chính

Hệ thống API cung cấp dữ liệu chuyển đổi chi tiết giữa các đơn vị hành chính cũ và mới theo các nghị quyết sáp nhập năm 2025.

Xác thực API

Các API công khai (public) không yêu cầu Access Token để tra cứu cơ bản. Đối với việc xử lý hàng loạt và yêu cầu tần suất cao, vui lòng liên hệ ban quản trị để đăng ký API Key.

Dữ liệu Hành chính Cũ (Hết hiệu lực 1/7/2025)

GETLấy danh sách Tỉnh/Thành phố cũ
/api/old-provinces
GETLấy danh sách Quận/Huyện cũ theo Tỉnh
/api/old-districts?province_code={code}
GETLấy danh sách Phường/Xã cũ theo Huyện
/api/old-wards?district_code={code}
GETLấy danh sách Thôn/Tổ/Ấp cũ theo Xã
/api/old-villages?ward_code={code}

Dữ liệu Hành chính Mới (Hiệu lực từ 1/7/2025)

GETLấy danh sách Tỉnh/Thành phố mới
/api/provinces
GETLấy danh sách Phường/Xã mới theo Tỉnh (Dành riêng cho đơn vị thay đổi)
/api/wards?province_code={code}
GETLấy danh sách Thôn/Tổ/Ấp mới theo Xã
/api/villages?ward_code={code}

Công cụ Chuyển đổi

GETChuyển đổi địa chỉ từ Cũ sang Mới
/api/convert/old-to-new?old_province_code={p}&old_district_code={d}&old_ward_code={w}
GETChuyển đổi địa chỉ từ Mới sang Cũ
/api/convert/new-to-old?province_code={p}&ward_code={w}
POSTChuyển đổi hàng loạt (Body: { addresses: string[], direction: "old-to-new" | "new-to-old" })
/api/convert/bulk

Ví dụ phản hồi (JSON)

{
  "status": "success",
  "data": {
    "provinces": [
      {
        "code": "01",
        "name": "Hà Nội",
        "full_name": "Thành phố Hà Nội"
      }
    ]
  }
}