Tra mã bưu chính, mã ZIP 34 tỉnh thành sau sáp nhập

Tra mã bưu chính 5 số của mọi phường, xã mới (QĐ 2334/QĐ-BKHCN năm 2025), liệt kê mã của một tỉnh hoặc kiểm tra một mã thuộc phường, xã nào.

Kết quả

Bấm “Chạy” để xem kết quả.

API mã bưu chính dùng hệ thống Mã bưu chính quốc gia (Quyết định 2475/QĐ-BTTTT), đã được sửa đổi theo việc sắp xếp đơn vị hành chính năm 2025 bởi Quyết định 2334/QĐ-BKHCN ngày 24/8/2025: 34 tỉnh, thành và khoảng 3.300 phường, xã, đặc khu, mỗi đơn vị có một mã 5 số. Gửi một mã (/v1/vn-postcode/11120) để biết mã đó có thuộc phường, xã nào không và dải mã thuộc tỉnh nào; gửi đầu mã (711) để liệt kê các mã bên dưới; tìm theo tên phường, xã với q (có hoặc không dấu, ben thanh), có thể kèm province; hoặc chỉ province để liệt kê mã của mọi phường, xã trong tỉnh.

Mã đúng định dạng nhưng không gán cho phường, xã nào sẽ có assigned_to_ward: false (bưu cục và khách hàng lớn có mã riêng); mã 6 số cũ trước năm 2018 bị từ chối. Tên và mã đơn vị hành chính lấy từ dữ liệu đơn vị hành chính của chúng tôi (/v1/vn-provinces), cập nhật hằng tuần từ nguồn chính thức.

Dùng trong code của bạn

curl "https://apibox.io.vn/v1/vn-postcode/11120" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-postcode/11120', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vn-postcode/11120",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-postcode/11120');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

Đây có phải mã sau sáp nhập năm 2025 không?

Đúng: mã cấp xã theo Quyết định 2334/QĐ-BKHCN (24/8/2025) cho các phường, xã, đặc khu mới.

Vì sao một tỉnh có nhiều đầu mã 2 số?

Tỉnh mới giữ dải mã của các tỉnh cũ hợp thành, ví dụ TP. Hồ Chí Minh dùng 70–75 và 78.

Mã đúng nhưng không thuộc phường, xã nào là sao?

Bưu cục, cơ quan nhà nước và khách hàng lớn có mã riêng trong dải mã của tỉnh; API trả về assigned_to_ward: false.