Giải mã thẻ BHYT API

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.

Tham số

Ví dụ

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

Kết quả trả về

{
  "input": "DN4797931234567",
  "normalized": "DN4797931234567",
  "formatted": "DN 4 79 7931234567",
  "format": "card code (15 characters)",
  "valid": true,
  "errors": [],
  "warnings": [],
  "group": {
    "code": "DN",
    "vi": "Người lao động làm việc theo hợp đồng lao động, người quản lý trong doanh nghiệp nhà nước",
    "en": "Employees and managers of state-owned enterprises",
    "category": {
      "number": 1,
      "vi": "Nhóm do người lao động và người sử dụng lao động đóng",
      "en": "Paid by employer and employee"
    },
    "legacy": false,
    "usual_benefit_level": 4
  },
  "benefit_level": {
    "level": 4,
    "percent": 80,
    "vi": "80% chi phí KCB trong phạm vi được hưởng; 100% khi KCB tại tuyến xã, chi phí một lần dưới 15% lương cơ sở hoặc đủ 5 năm liên tục và chi trả cùng trong năm vượt 6 tháng lương cơ sở",
    "en": "80% of covered costs; 100% at commune level, below 15% of the base salary per visit, or after 5 consecutive years once co-payments exceed 6 months of base salary"
  },
  "province": {
    "code": "79",
    "name": "TP. Hồ Chí Minh",
    "since_2025": "TP. Hồ Chí Minh"
  },
  "social_insurance_number": "7931234567",
  "legal_basis": "QĐ 1351/QĐ-BHXH (card code structure); Công văn 1804/BHXH-QLT 04/08/2025, Phụ lục I (group codes, benefit levels); Luật BHYT 2008 amended by Luật 51/2024/QH15 (Điều 22)",
  "reviewed": "2026-11-11"
}

Ứng dụng

• Hiển thị tỷ lệ chi trả khi tiếp đón tại bệnh viện, nhà thuốc
• Kiểm tra mã thẻ nhập vào phần mềm HIS
• Thống kê bệnh nhân theo nhóm đối tượng
• Giải thích mã thẻ cho khách hàng trong ứng dụng bảo hiểm

Hỏi đáp

API liên quan