Trợ cấp BHXH, thất nghiệp API

Tính trợ cấp thất nghiệp, BHXH một lần theo hệ số trượt giá 2026, trợ cấp thôi việc, mất việc và chế độ thai sản theo luật đang có hiệu lực.

GETPOSThttps://apibox.io.vn/v1/vn-insurance-benefits
Dữ liệu & JSON▶ Dùng thử online

Một endpoint, năm phép tính chọn bằng type. unemployment: mức hưởng bằng 60% bình quân tiền lương đóng BHTN của 6 tháng gần nhất, tối đa 5 lần lương tối thiểu vùng; đóng từ 12 đến dưới 36 tháng được 3 tháng, sau đó cứ thêm 12 tháng được thêm 1 tháng, tối đa 12 tháng (Luật Việc làm 74/2025/QH15). Vùng lấy từ region hoặc tên phường, xã.

lump_sum (BHXH một lần): gửi các giai đoạn đóng periods kèm tiền lương; từng tháng được điều chỉnh theo hệ số trượt giá năm 2026 (Công văn 340/BHXH-CSXH), sau đó tính 1,5 tháng lương bình quân cho mỗi năm trước 2014 và 2 tháng cho mỗi năm từ 2014, làm tròn tháng lẻ đúng quy định (Luật BHXH 41/2024/QH15 Điều 70). Kết quả cũng cho biết có đủ điều kiện rút một lần theo quy định từ 1/7/2025 hay không.

severance (thôi việc) và job_loss (mất việc) theo Bộ luật Lao động 2019 Điều 46–47, trừ thời gian đã đóng BHTN; maternity (thai sản) trả về trợ cấp một lần (2 lần mức tham chiếu, 2.530.000 đồng từ 1/7/2026), tiền nghỉ sinh 6 tháng của mẹ và số ngày nghỉ của cha.

Tham số

TênVị tríKiểuBắt buộcMặc định
typequery|bodystringcóunemployment (thất nghiệp), lump_sum (BHXH một lần), severance (thôi việc), job_loss (mất việc), maternity (thai sản).
salaryquery|bodynumberkhôngTiền lương bình quân tháng (lương đóng bảo hiểm, hoặc lương theo hợp đồng khi tính thôi việc).
salariesbodyarraykhôngThất nghiệp: tiền lương đóng của 6 tháng gần nhất.
contribution_monthsquery|bodynumberkhôngThất nghiệp: số tháng đã đóng BHTN.
regionquery|bodystringkhôngIThất nghiệp: vùng I–IV (hoặc ward + province).
last_monthquery|bodystringkhôngThất nghiệp: tháng đóng cuối cùng (YYYY-MM).
periodsbodyarraykhôngBHXH một lần: [{"from":"2015-01","to":"2020-12","salary":8000000}].
start_datequery|bodystringkhôngThôi việc: ngày bắt đầu làm việc.
end_datequery|bodystringkhôngThôi việc: ngày chấm dứt hợp đồng.
unemployment_insurance_monthsquery|bodynumberkhôngThôi việc: số tháng đã đóng BHTN (được trừ).
birth_datequery|bodystringkhôngThai sản: ngày sinh con (lấy mức tham chiếu tháng đó).
childrenquery|bodynumberkhông1Thai sản: số con sinh ra.

Ví dụ

curl -X POST "https://apibox.io.vn/v1/vn-insurance-benefits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"unemployment","salary":10000000,"contribution_months":40,"region":"I"}'

Kết quả trả về

{
  "type": "unemployment",
  "average_salary": 10000000,
  "contribution_months": 40,
  "eligible": true,
  "monthly_benefit": 6000000,
  "capped": false,
  "cap": {
    "amount": 26550000,
    "rule": "5 × regional minimum wage of the last contribution month",
    "region": "I",
    "region_from": "region",
    "min_wage": 5310000,
    "decree": "293/2025/NĐ-CP"
  },
  "benefit_months": 4,
  "total": 24000000,
  "reserved_months": 4,
  "payment_start": "from the 11th working day after a complete application",
  "legal": "Luật Việc làm 74/2025/QH15 Điều 38, 39 (from 1/1/2026): 60% of the average contribution wage of the last 6 months, max 5 × regional minimum wage; 12 to under 36 months -> 3 months, +1 month per further 12 months, max 12 months.",
  "reviewed": "2026-11-11"
}

Ứng dụng

  • Thêm công cụ tính trợ cấp thất nghiệp vào trang tuyển dụng
  • Ước tính tiền rút BHXH một lần trong app tài chính cá nhân
  • Tính trợ cấp thôi việc trong phần mềm nhân sự, tiền lương
  • Hiển thị chế độ thai sản trên cổng thông tin nhân viên

Hỏi đáp

BHXH một lần dùng hệ số trượt giá nào?

Bảng năm 2026 theo Công văn 340/BHXH-CSXH (5,81 cho trước 1995 đến 1,00 cho 2025–2026), áp dụng cho từng tháng của mỗi giai đoạn.

Ai còn được rút BHXH một lần?

Người đóng BHXH trước 1/7/2025, chưa đủ 20 năm, sau 12 tháng không tham gia; các trường hợp khác chỉ được rút khi thuộc diện đặc biệt tại Điều 70. Kết quả ghi rõ trường hợp áp dụng.

Mức trần trợ cấp thất nghiệp lấy thế nào?

5 lần lương tối thiểu vùng tại tháng đóng cuối cùng (vùng I năm 2026 là 5.310.000 đồng), theo region hoặc phường, xã tra trong danh mục NĐ 293/2025.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →