BHXH tự nguyện và BHYT hộ gia đình API

Mức đóng BHXH tự nguyện theo tháng, 3/6/12 tháng hoặc nhiều năm, có hỗ trợ của Nhà nước và tỉnh; BHYT hộ gia đình cho từng thành viên.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/vn-voluntary-insurance?type=both&income=2000000&group=near_poor&method=12&province=H%E1%BA%A3i%20Ph%C3%B2ng&members=3&months=12&date=2026-11-11" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-voluntary-insurance?type=both&income=2000000&group=near_poor&method=12&province=H%E1%BA%A3i%20Ph%C3%B2ng&members=3&months=12&date=2026-11-11', {
  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-voluntary-insurance?type=both&income=2000000&group=near_poor&method=12&province=H%E1%BA%A3i%20Ph%C3%B2ng&members=3&months=12&date=2026-11-11",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-voluntary-insurance?type=both&income=2000000&group=near_poor&method=12&province=H%E1%BA%A3i%20Ph%C3%B2ng&members=3&months=12&date=2026-11-11');
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ề

{
  "province": {
    "code": "31",
    "name": "Hải Phòng"
  },
  "bhxh": {
    "type": "bhxh_voluntary",
    "date": "2026-11-11",
    "group": "near_poor",
    "income": 2000000,
    "rate": 0.22,
    "method": "12_months",
    "months": 12,
    "monthly_contribution": 440000,
    "gross_amount": 5280000,
    "support": {
      "national_percent": 0.4,
      "local_percent": 0.25,
      "total_percent": 0.65,
      "base": 330000,
      "months_supported": 12,
      "monthly_national": 132000,
      "monthly_local": 82500,
      "national": 1584000,
      "local": 990000,
      "total": 2574000,
      "local_ref": "NQ 56/2025/NQ-HĐND TP Hải Phòng (11/12/2025), luatvietnam.vn"
    },
    "you_pay": 2706000,
    "limits": {
      "income_min": 1500000,
      "income_min_ref": "NĐ 07/2021/NĐ-CP (chuẩn nghèo nông thôn, kéo dài đến 31/12/2026)",
      "income_max": 50600000,
      "reference_level": 2530000,
      "reference_level_ref": "Nghị định 161/2026/NĐ-CP"
    },
    "notes": [],
    "unverified": []
  },
  "bhyt": {
    "type": "bhyt_household",
    "date": "2026-11-11",
    "months": 12,
    "members": 3,
    "base_salary": 2530000,
    "base_salary_ref": "Nghị định 161/2026/NĐ-CP",
    "rate": 0.045,
    "first_member_monthly": 113850,
    "ladder": {
      "1": 1,
      "2": 0.7,
      "3": 0.6,
      "4": 0.5,
      "5+": 0.4
    },
    "rows": [
      {
        "member": 1,
        "name": null,
        "factor": 1,
        "monthly": 113850,
        "amount": 1366200,
        "local_support_percent": 0,
        "local_support": 0,
        "you_pay": 1366200,
        "support_rules": []
      },
      {
        "member": 2,
        "name": null,
        "factor": 0.7,
        "monthly": 79695,
        "amount": 956340,
        "local_support_percent": 0,
        "local_support": 0,
        "you_pay": 956340,
        "support_rules": []
      }
    ],
    "total": 3142260,
    "you_pay": 3142260,
    "notes": [
      "The 70/60/50/40% ladder applies to household members joining in the same fiscal year, in joining order.",
      "If the base salary changes after payment there is no top-up or refund for the period already paid (NĐ 188/2025 Điều 8 k.3)."
    ]
  },
  "coverage": [
    "Hà Nội",
    "TP. Hồ Chí Minh",
    "Hải Phòng",
    "Đà Nẵng"
  ],
  "legal": [
    {
      "ref": "Luật BHXH 41/2024/QH15 (Điều 31, 36)",
      "effective_from": "2025-07-01"
    },
    {
      "ref": "NĐ 159/2025/NĐ-CP (BHXH tự nguyện)",
      "effective_from": "2025-07-01"
    }
  ],
  "reviewed": "2026-11-11",
  "disclaimer": "Reference calculation, not legal advice; check the official text."
}

Ứng dụng

• Hiển thị số tiền cần đóng trong ứng dụng ví hoặc thu hộ bảo hiểm
• So sánh đóng hằng tháng và đóng theo năm cho khách hàng
• Tính BHYT hộ gia đình cho gia đình năm người
• Giải thích phần Nhà nước và tỉnh hỗ trợ

Hỏi đáp

API liên quan