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.
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ên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
type | query|body | string | có | 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). | |
salary | query|body | number | không | Tiề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). | |
salaries | body | array | không | Thất nghiệp: tiền lương đóng của 6 tháng gần nhất. | |
contribution_months | query|body | number | không | Thất nghiệp: số tháng đã đóng BHTN. | |
region | query|body | string | không | I | Thất nghiệp: vùng I–IV (hoặc ward + province). |
last_month | query|body | string | không | Thất nghiệp: tháng đóng cuối cùng (YYYY-MM). | |
periods | body | array | không | BHXH một lần: [{"from":"2015-01","to":"2020-12","salary":8000000}]. | |
start_date | query|body | string | không | Thôi việc: ngày bắt đầu làm việc. | |
end_date | query|body | string | không | Thôi việc: ngày chấm dứt hợp đồng. | |
unemployment_insurance_months | query|body | number | không | Thôi việc: số tháng đã đóng BHTN (được trừ). | |
birth_date | query|body | string | không | Thai sản: ngày sinh con (lấy mức tham chiếu tháng đó). | |
children | query|body | number | không | 1 | Thai 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"}'const res = await fetch('https://apibox.io.vn/v1/vn-insurance-benefits', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "unemployment",
"salary": 10000000,
"contribution_months": 40,
"region": "I"
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-insurance-benefits",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"type": "unemployment", "salary": 10000000, "contribution_months": 40, "region": "I"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-insurance-benefits');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"type":"unemployment","salary":10000000,"contribution_months":40,"region":"I"}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));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
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.