Every endpoint accepts GET with query parameters; endpoints that take amounts also accept POST with the same fields in a JSON or form body, and answer no-store. For salaries, use POST: a GET query string ends up in proxy and web-server logs, a request body does not. Amounts may contain digit separators (30.000.000 or 30,000,000). JSON responses, CORS open for any site. The REST endpoints and the MCP tools share the same input schemas and the same response format.
Gross to net for a month before 1 July 2026 (insurance cap of that month)
curl -X POST "https://since98.vn/api/v1/payroll/gross-to-net" \
-H "Content-Type: application/json" \
-d '{"gross":50000000,"region":"I","dependents":0,"as_of":"2026-03"}'
Response (real output on the current data){
"as_of": "2026-03-01",
"region": "I",
"residency": "resident",
"nationality": "vietnamese",
"dependents": 0,
"gross": 50000000,
"net": 42598600,
"employee_contributions": {
"lines": [
{
"fund": "social_insurance",
"rate": 0.08,
"base": 46800000,
"amount": 3744000
},
{
"fund": "health_insurance",
"rate": 0.015,
"base": 46800000,
"amount": 702000
},
{
"fund": "unemployment_insurance",
"rate": 0.01,
"base": 50000000,
"amount": 500000
}
],
"total": 4946000
},
"pit": {
"method": "progressive",
"income": 50000000,
"deductions": {
"insurance": 4946000,
"personal": 15500000,
"dependents": 0,
"dependents_amount": 0,
"total": 20446000
},
"taxable_income": 29554000,
"brackets": [
{
"bracket": 1,
"from": 0,
"to": 10000000,
"rate": 0.05,
"amount": 10000000,
"tax": 500000
},
{
"bracket": 2,
"from": 10000000,
"to": 30000000,
"rate": 0.1,
"amount": 19554000,
"tax": 1955400
}
],
"tax": 2455400
},
"employer": {
"lines": [
{
"fund": "social_insurance_sickness_maternity",
"rate": 0.03,
"base": 46800000,
"amount": 1404000
},
{
"fund": "social_insurance_retirement_survivorship",
"rate": 0.14,
"base": 46800000,
"amount": 6552000
},
{
"fund": "occupational_accident_disease",
"rate": 0.005,
"base": 46800000,
"amount": 234000
},
{
"fund": "health_insurance",
"rate": 0.03,
"base": 46800000,
"amount": 1404000
},
{
"fund": "unemployment_insurance",
"rate": 0.01,
"base": 50000000,
"amount": 500000
}
],
"insurance_total": 10094000,
"union_fund": {
"fund": "trade_union_fund_kpcd",
"rate": 0.02,
"base": 46800000,
"amount": 936000
},
"total": 11030000,
"total_cost": 61030000
},
"insurance_base": {
"requested_base": 50000000,
"raised_to_minimum": false,
"si_hi_base": 46800000,
"ui_base": 50000000,
"si_hi_ceiling": 46800000,
"ui_ceiling": 106200000,
"regional_minimum": 5310000
},
"notes": [
"Social and health insurance base capped at 46800000 VND (20 x the base salary).",
"For all of 2026 the 5-bracket scale and the 15.5 / 6.2 million VND family deductions apply (Law 109/2025/QH15 Art. 29(2): salary provisions apply from tax period 2026). Payers who withheld January-June 2026 under the old rules adjust in the 2026 annual finalization (Decree 253/2026/ND-CP Art. 70(2)).",
"Employer trade union fund (KPCD) of 2% of the social insurance salary fund (Law on Trade Unions 50/2024/QH15 Art. 29(1)(b)); it is an employer cost, not deducted from the employee.",
"Occupational accident and disease insurance at 0.5%. The reduced 0.3% rate (requires an approved application) and the draft decree reducing it to 0.3% are not applied.",
"Region (I-IV) is chosen by the user; there is no locality-to-region lookup. The list of communes per region changes from 1 January 2027 (Decree 399/2026/ND-CP replaces Decree 293/2025/ND-CP).",
"Not included: tax-exempt or capped allowances (meals, phone, uniform, stationery, per diem, housing), overtime and night-work pay, voluntary pension or life insurance, charity deductions. The whole gross amount is treated as taxable salary."
],
"sources": [
{
"parameter": "regional_minimum_wage",
"act": "293/2025/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/nghi-dinh-so-293-2025-nd-cp-46568/59713.htm",
"verified": "text_opened"
},
{
"parameter": "si_hi_contribution_base_ceiling",
"act": "41/2024/QH15 + 73/2024/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-41-2024-qh15-42576.htm",
"verified": "text_opened"
},
{
"parameter": "ui_contribution_base_ceiling",
"act": "74/2025/QH15 + 293/2025/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-74-2025-qh15-45562.htm",
"verified": "text_opened"
},
{
"parameter": "contribution_rates_vietnamese_employee",
"act": "41/2024/QH15; 51/2024/QH15 (Luật BHYT sửa đổi) + 188/2025/NĐ-CP; 74/2025/QH15 + 374/2025/NĐ-CP; 58/2020/NĐ-CP as amended by 158/2025/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-41-2024-qh15-42576.htm",
"verified": "text_opened"
},
{
"parameter": "base_salary_luong_co_so",
"act": "73/2024/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/nghi-dinh-so-73-2024-nd-cp-42169/50685.htm",
"verified": "text_opened"
},
{
"parameter": "pit_resident_progressive_scale",
"act": "109/2025/QH15",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-109-2025-qh15-468671.htm",
"verified": "text_opened"
},
{
"parameter": "pit_family_deduction",
"act": "110/2025/UBTVQH15",
"url": "https://vanban.chinhphu.vn/?pageid=27160&docid=215927",
"verified": "text_opened"
},
{
"parameter": "pit_insurance_deductible",
"act": "109/2025/QH15",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-109-2025-qh15-468671.htm",
"verified": "text_opened"
},
{
"parameter": "trade_union_funding_employer_kpcd",
"act": "50/2024/QH15",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-50-2024-qh15-43589.htm",
"verified": "text_opened"
}
],
"data_version": "2026.11.21",
"disclaimer": "Reference calculation only, not tax, legal or accounting advice. Verify the figures against the cited acts before relying on them."
}
Net to gross with one dependent
curl -X POST "https://since98.vn/api/v1/payroll/net-to-gross" \
-H "Content-Type: application/json" \
-d '{"net":30000000,"region":"I","dependents":1,"as_of":"2026-11"}'
Response (real output on the current data){
"as_of": "2026-11-01",
"region": "I",
"residency": "resident",
"nationality": "vietnamese",
"dependents": 1,
"target_net": 30000000,
"net_difference": 0,
"gross": 34007645,
"net": 30000000,
"employee_contributions": {
"lines": [
{
"fund": "social_insurance",
"rate": 0.08,
"base": 34007645,
"amount": 2720612
},
{
"fund": "health_insurance",
"rate": 0.015,
"base": 34007645,
"amount": 510115
},
{
"fund": "unemployment_insurance",
"rate": 0.01,
"base": 34007645,
"amount": 340076
}
],
"total": 3570803
},
"pit": {
"method": "progressive",
"income": 34007645,
"deductions": {
"insurance": 3570803,
"personal": 15500000,
"dependents": 1,
"dependents_amount": 6200000,
"total": 25270803
},
"taxable_income": 8736842,
"brackets": [
{
"bracket": 1,
"from": 0,
"to": 10000000,
"rate": 0.05,
"amount": 8736842,
"tax": 436842
}
],
"tax": 436842
},
"employer": {
"lines": [
{
"fund": "social_insurance_sickness_maternity",
"rate": 0.03,
"base": 34007645,
"amount": 1020229
},
{
"fund": "social_insurance_retirement_survivorship",
"rate": 0.14,
"base": 34007645,
"amount": 4761070
},
{
"fund": "occupational_accident_disease",
"rate": 0.005,
"base": 34007645,
"amount": 170038
},
{
"fund": "health_insurance",
"rate": 0.03,
"base": 34007645,
"amount": 1020229
},
{
"fund": "unemployment_insurance",
"rate": 0.01,
"base": 34007645,
"amount": 340076
}
],
"insurance_total": 7311642,
"union_fund": {
"fund": "trade_union_fund_kpcd",
"rate": 0.02,
"base": 34007645,
"amount": 680153
},
"total": 7991795,
"total_cost": 41999440
},
"insurance_base": {
"requested_base": 34007645,
"raised_to_minimum": false,
"si_hi_base": 34007645,
"ui_base": 34007645,
"si_hi_ceiling": 50600000,
"ui_ceiling": 106200000,
"regional_minimum": 5310000
},
"notes": [
"Employer trade union fund (KPCD) of 2% of the social insurance salary fund (Law on Trade Unions 50/2024/QH15 Art. 29(1)(b)); it is an employer cost, not deducted from the employee.",
"Occupational accident and disease insurance at 0.5%. The reduced 0.3% rate (requires an approved application) and the draft decree reducing it to 0.3% are not applied.",
"Region (I-IV) is chosen by the user; there is no locality-to-region lookup. The list of communes per region changes from 1 January 2027 (Decree 399/2026/ND-CP replaces Decree 293/2025/ND-CP).",
"Not included: tax-exempt or capped allowances (meals, phone, uniform, stationery, per diem, housing), overtime and night-work pay, voluntary pension or life insurance, charity deductions. The whole gross amount is treated as taxable salary."
],
"sources": [
{
"parameter": "regional_minimum_wage",
"act": "293/2025/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/nghi-dinh-so-293-2025-nd-cp-46568/59713.htm",
"verified": "text_opened"
},
{
"parameter": "si_hi_contribution_base_ceiling",
"act": "41/2024/QH15 + 161/2026/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-41-2024-qh15-42576.htm",
"verified": "text_opened"
},
{
"parameter": "ui_contribution_base_ceiling",
"act": "74/2025/QH15 + 293/2025/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-74-2025-qh15-45562.htm",
"verified": "text_opened"
},
{
"parameter": "contribution_rates_vietnamese_employee",
"act": "41/2024/QH15; 51/2024/QH15 (Luật BHYT sửa đổi) + 188/2025/NĐ-CP; 74/2025/QH15 + 374/2025/NĐ-CP; 58/2020/NĐ-CP as amended by 158/2025/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-41-2024-qh15-42576.htm",
"verified": "text_opened"
},
{
"parameter": "base_salary_luong_co_so",
"act": "161/2026/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/nghi-dinh-so-161-2026-nd-cp-469550/65052.htm",
"verified": "text_opened"
},
{
"parameter": "pit_resident_progressive_scale",
"act": "109/2025/QH15",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-109-2025-qh15-468671.htm",
"verified": "text_opened"
},
{
"parameter": "pit_family_deduction",
"act": "110/2025/UBTVQH15",
"url": "https://vanban.chinhphu.vn/?pageid=27160&docid=215927",
"verified": "text_opened"
},
{
"parameter": "pit_insurance_deductible",
"act": "109/2025/QH15",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-109-2025-qh15-468671.htm",
"verified": "text_opened"
},
{
"parameter": "trade_union_funding_employer_kpcd",
"act": "50/2024/QH15",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-50-2024-qh15-43589.htm",
"verified": "text_opened"
}
],
"data_version": "2026.11.21",
"disclaimer": "Reference calculation only, not tax, legal or accounting advice. Verify the figures against the cited acts before relying on them."
}
Regional minimum wage from 1 January 2027
curl "https://since98.vn/api/v1/payroll/minimum-wage?as_of=2027-01"
Response (real output on the current data){
"as_of": "2027-01-01",
"effective_from": "2027-01-01",
"effective_to": null,
"regions": [
{
"region": "I",
"monthly": 5700000,
"hourly": 27400,
"ui_ceiling": 114000000
},
{
"region": "II",
"monthly": 5080000,
"hourly": 24400,
"ui_ceiling": 101600000
},
{
"region": "III",
"monthly": 4450000,
"hourly": 21400,
"ui_ceiling": 89000000
},
{
"region": "IV",
"monthly": 4040000,
"hourly": 19400,
"ui_ceiling": 80800000
}
],
"notes": [
"Region (I-IV) is chosen by the user; there is no locality-to-region lookup. The list of communes per region changes from 1 January 2027 (Decree 399/2026/ND-CP replaces Decree 293/2025/ND-CP).",
"Parameters as known on 2026-11-21; changes adopted after that date are not reflected."
],
"sources": [
{
"parameter": "regional_minimum_wage",
"act": "399/2026/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/nghi-dinh-so-399-2026-nd-cp-470908.htm",
"verified": "text_opened"
},
{
"parameter": "ui_contribution_base_ceiling",
"act": "74/2025/QH15 + 399/2026/NĐ-CP",
"url": "https://congbao.chinhphu.vn/van-ban/luat-so-74-2025-qh15-45562.htm",
"verified": "text_opened"
}
],
"data_version": "2026.11.21",
"disclaimer": "Reference calculation only, not tax, legal or accounting advice. Verify the figures against the cited acts before relying on them."
}
Amount in words with «đồng chẵn»
curl -X POST "https://since98.vn/api/v1/payroll/amount-in-words" \
-H "Content-Type: application/json" \
-d '{"amount":1234567891,"vi_chan":true,"capitalize":true}'
Response (real output on the current data){
"amount": 1234567891,
"vi": "Một tỷ hai trăm ba mươi tư triệu năm trăm sáu mươi bảy nghìn tám trăm chín mươi mốt đồng chẵn",
"en": "One billion two hundred thirty-four million five hundred sixty-seven thousand eight hundred ninety-one dong",
"data_version": "2026.11.21",
"disclaimer": "Reference calculation only, not tax, legal or accounting advice. Verify the figures against the cited acts before relying on them."
}