Tra ý nghĩa mã thẻ bảo hiểm y tế (BHYT) online

Giải mã mã thẻ bảo hiểm y tế: nhóm đối tượng, mức hưởng và tỷ lệ chi trả, tỉnh phát hành, mã số BHXH; theo danh mục mới nhất của BHXH Việt Nam.

Kết quả

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

Mã thẻ BHYT gồm 15 ký tự, ví dụ DN4797931234567: 2 chữ cái là mã đối tượng (DN = người lao động trong doanh nghiệp, HT = người hưởng lương hưu, TE = trẻ em dưới 6 tuổi, HS / SV = học sinh / sinh viên…), 1 chữ số là mức hưởng (1–5), 2 chữ số là mã tỉnh phát hành thẻ và 10 số cuối là mã số BHXH. API tách mã và giải thích từng phần bằng tiếng Việt và tiếng Anh.

Mã đối tượng và mức hưởng theo Phụ lục I Công văn 1804/BHXH-QLT (04/08/2025, sau Luật BHYT sửa đổi 2024): 65 mã trong năm nhóm (người sử dụng lao động đóng, quỹ BHXH đóng, ngân sách đóng, ngân sách hỗ trợ, tự đóng), cùng các mã cũ còn in trên thẻ. Mức hưởng trả kèm tỷ lệ chi trả (100%, 95%, 80%…) và điều kiện. Mức hưởng khác mức thông thường của nhóm chỉ là cảnh báo, vì người thuộc nhiều đối tượng được hưởng theo đối tượng có quyền lợi cao nhất. codes kiểm tra tối đa 500 mã một lần, list=true trả toàn bộ bảng mã.

API chỉ giải mã cấu trúc: không tra cứu trên cổng BHXH (không biết hạn thẻ và nơi đăng ký KCB ban đầu) và không lưu dữ liệu.

Dùng trong code của bạn

curl "https://apibox.io.vn/v1/bhyt-check?code=DN4797931234567" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/bhyt-check?code=DN4797931234567', {
  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/bhyt-check?code=DN4797931234567",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/bhyt-check?code=DN4797931234567');
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

Mã 10 số hoặc 12 số mới thì sao?

Thẻ điện tử hiển thị mã số BHXH 10 số, và từ 08/2025 số định danh 12 số dần thay thế. API chấp nhận các mã này nhưng chúng không chứa mã đối tượng hay mức hưởng: hãy dùng mã thẻ 15 ký tự.

Có biết thẻ còn hạn không?

Không, hạn thẻ không nằm trong mã. Hãy xem trên thẻ, VssID hoặc VNeID.

Vì sao mức hưởng bị đánh dấu bất thường?

Mỗi nhóm có mức hưởng thông thường (DN → 4 = 80%). Mức khác vẫn có thể đúng khi người đó thuộc thêm đối tượng có quyền lợi cao hơn, nên chỉ là cảnh báo.