Tìm phường/xã trong danh mục CŨ (10.051 đơn vị) theo tên hoặc theo

Tỉnh/huyện cũ, chủ yếu để lấy đúng `ward_code` rồi đưa sang GET api/vn/convert cho kết quả chắc chắn nhất.

GET https://api-tools.hitechcloud.vn/api/vn/legacy/wards Đã chép

Cần khoá API

Tham số

q string · truy vấn

Một phần tên phường/xã cũ, có dấu hoặc không dấu. Bắt buộc nếu không lọc theo province/district.

province integer · truy vấn

Mã tỉnh CŨ (63 tỉnh trước sáp nhập), lấy tại GET api/vn/legacy/provinces.

district integer · truy vấn

Mã quận/huyện CŨ, lấy tại GET api/vn/legacy/provinces/{code}/districts.

limit integer · truy vấn

Số dòng trả về, 1–200, mặc định 50. Trường total cho biết tổng số dòng khớp.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

Ví dụ gọi

bash

curl --location 'https://api-tools.hitechcloud.vn/api/vn/legacy/wards?q=GIA_TRI&province=GIA_TRI&district=GIA_TRI&limit=GIA_TRI' \
--header 'X-API-Key: $HITECH_API_KEY' \
--header 'Accept: application/json'

php

$response = Http::withHeaders([
    'X-API-Key' => env('HITECH_API_KEY'),
])->get('https://api-tools.hitechcloud.vn/api/vn/legacy/wards', [
    'q' => 'GIA_TRI',
    'province' => 'GIA_TRI',
    'district' => 'GIA_TRI',
    'limit' => 'GIA_TRI',
]);

$data = $response->json();

javascript

const q = new URLSearchParams({
  q: 'GIA_TRI',
  province: 'GIA_TRI',
  district: 'GIA_TRI',
  limit: 'GIA_TRI',
});

const res = await fetch(`https://api-tools.hitechcloud.vn/api/vn/legacy/wards?${q}`, {
  headers: { 'X-API-Key': process.env.HITECH_API_KEY },
});

const data = await res.json();

python

import os, requests

res = requests.get(
    "https://api-tools.hitechcloud.vn/api/vn/legacy/wards",
    headers={"X-API-Key": os.environ["HITECH_API_KEY"]},
    params={
        "q": "GIA_TRI",
        "province": "GIA_TRI",
        "district": "GIA_TRI",
        "limit": "GIA_TRI",
    },
)
data = res.json()

Đã chép mã

Thử ngay

X-API-Key

Khoá chỉ lưu trong trình duyệt của bạn. Lấy khoá →

q truy vấn

province truy vấn

district truy vấn

limit truy vấn

Cùng nhóm

GET Danh sách quốc gia kèm mã ISO và mã điện thoại GET Tra ngược từ mã bưu chính năm chữ số ra các xã... GET Danh sách 34 tỉnh và thành phố trực thuộc trun... GET Chi tiết một tỉnh hoặc thành phố trực thuộc tr... GET Toàn bộ xã GET Đoán tỉnh và xã/phường từ một chuỗi địa chỉ tự...