Logo Tra cứu địa chỉ

Tra cứu địa chỉ sau sáp nhập

Tài liệu API

API tra cứu địa chỉ hành chính sau sáp nhập theo Nghị quyết 76/2025/UBTVQH15

Tổng quan

API cung cấp các endpoint để tra cứu thông tin địa chỉ hành chính sau khi sắp xếp, sáp nhập theo Nghị quyết 76/2025/UBTVQH15.

Tất cả các endpoint trả về dữ liệu dưới dạng JSON và sử dụng phương thức GET.

Endpoints

Lấy danh sách tỉnh, thành phố

GET /api/provinces

Ví dụ phản hồi:

[
  {
    "id": "01",
    "name": "Hà Nội"
  },
  {
    "id": "02",
    "name": "Hồ Chí Minh"
  }
]

Lấy danh sách quận, huyện

GET /api/districts?provinceId=01

Ví dụ phản hồi:

[
  {
    "id": "001",
    "name": "Ba Đình"
  },
  {
    "id": "002",
    "name": "Hoàn Kiếm"
  }
]

Lấy danh sách xã, phường

GET /api/wards?provinceId=01&districtId=001

Ví dụ phản hồi:

[
  {
    "id": "00001",
    "name": "Phường Cống Vị"
  },
  {
    "id": "00002",
    "name": "Phường Điện Biên"
  }
]

Tra cứu địa chỉ đầy đủ

GET /api/address?provinceId=01&districtId=001&wardId=00001

Ví dụ phản hồi:

{
  "ward": "Phường Cống Vị",
  "district": "Ba Đình",
  "province": "Hà Nội",
  "fullAddress": "Phường Cống Vị, Ba Đình, Hà Nội"
}

Lưu ý

  • • API hiện đang trong giai đoạn phát triển. Các endpoint có thể thay đổi.
  • • Dữ liệu phục vụ mục đích tra cứu, tham khảo theo Nghị quyết 76/2025/UBTVQH15.
  • • Không có giới hạn về số lượng request, tuy nhiên vui lòng sử dụng hợp lý.

Trạng thái

API đang trong giai đoạn phát triển. Vui lòng liên hệ để được hỗ trợ tích hợp.