Mã bưu chính Việt Nam API

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.

Tham số

Ví dụ

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));

Kết quả trả về

{
  "code": "11120",
  "valid_format": true,
  "assigned_to_ward": true,
  "province": {
    "code": "01",
    "name": "Thành phố Hà Nội",
    "postcode_prefixes": [
      "10",
      "11",
      "12",
      "13",
      "14"
    ]
  },
  "wards": [
    {
      "postal_code": "11120",
      "ward": "Phường Ba Đình",
      "ward_code": "00004",
      "province": "Thành phố Hà Nội",
      "province_code": "01"
    }
  ],
  "note": null,
  "decision": "2475/QĐ-BTTTT",
  "decision_date": "2017-12-29",
  "amended_by": "2334/QĐ-BKHCN",
  "amended_on": "2025-08-24",
  "effective_from": "2025-08-24",
  "structure": "NNXXX: 5 digits. NN = province (some provinces own several 2-digit ranges after the 2025 merger); the full 5 digits = a phường / xã / đặc khu, or a post office / special customer.",
  "reviewed": "2026-11-11"
}

Ứng dụng

• Điền ô ZIP trong form thanh toán quốc tế
• Kiểm tra mã bưu chính trong hệ thống vận chuyển, logistics
• Gợi ý mã bưu chính sau khi người dùng chọn phường, xã
• Làm sạch địa chỉ trong CRM, dữ liệu mở tài khoản ngân hàng

Hỏi đáp

API liên quan