{"success":true,"timestamp":"2026-11-21T20:23:03.976Z","data":{"title":"Vietnam Tax Calculator & Partner Risk Watchlist API","description":"Comprehensive public API for Vietnam 2026 tax calculations and SME/Individual partner tax risk verification.","base_url":"https://thue.cuthongthai.vn/api/tax","version":"1.1.0","endpoints":[{"path":"/personal-income","full_url":"https://thue.cuthongthai.vn/api/tax/personal-income","method":"POST","description":{"en":"Calculate Personal Income Tax (TNCN) using 5-bracket progressive system","vi":"Tính thuế Thu nhập cá nhân (TNCN) theo biểu 5 bậc lũy tiến"},"example_request":{"salary":30,"bonus":5,"allowance":2,"dependents":1}},{"path":"/business-household","full_url":"https://thue.cuthongthai.vn/api/tax/business-household","method":"POST","description":{"en":"Calculate Business Household Tax (Thuế Hộ Kinh Doanh)","vi":"Tính thuế Hộ Kinh Doanh (HKD) theo tỷ lệ % doanh thu"},"example_request":{"annual_revenue":800,"business_category":"services"}},{"path":"/social-insurance","full_url":"https://thue.cuthongthai.vn/api/tax/social-insurance","method":"POST","description":{"en":"Calculate Social Insurance contributions (BHXH, BHYT, BHTN)","vi":"Tính đóng Bảo hiểm xã hội, BHYT, BHTN"},"example_request":{"salary":15,"type":"employee"}},{"path":"/investment","full_url":"https://thue.cuthongthai.vn/api/tax/investment","method":"POST","description":{"en":"Calculate Investment Income Tax (Dividend, Bond, Stock, Savings)","vi":"Tính thuế đầu tư (Cổ tức, Trái phiếu, Chứng khoán, Tiết kiệm)"},"example_request":{"type":"dividend","amount":100}},{"path":"/rental","full_url":"https://thue.cuthongthai.vn/api/tax/rental","method":"POST","description":{"en":"Calculate Rental Property Tax","vi":"Tính thuế cho thuê tài sản (BĐS, Xe...)"},"example_request":{"annual_revenue":600,"has_services":false,"property_count":1}},{"path":"/ecommerce","full_url":"https://thue.cuthongthai.vn/api/tax/ecommerce","method":"POST","description":{"en":"Calculate E-commerce Tax (Shopee, Lazada, TikTok Shop)","vi":"Tính thuế bán hàng sàn TMĐT (Shopee, Lazada, TikTok)"},"example_request":{"platform_revenue":800,"offline_revenue":100,"product_type":"Goods"}},{"path":"/overtime","full_url":"https://thue.cuthongthai.vn/api/tax/overtime","method":"POST","description":{"en":"Calculate Overtime Pay with Tax-Exempt Portion","vi":"Tính lương OT và phần miễn thuế TNCN"},"example_request":{"base_salary":15,"standard_days":22,"hours_ot":10,"ot_type":"weekday"}},{"path":"/lending","full_url":"https://thue.cuthongthai.vn/api/tax/lending","method":"POST","description":{"en":"Calculate P2P Lending Income Tax (10% on interest)","vi":"Tính thuế cho vay P2P (10% trên lãi)"},"example_request":{"loan_amount":100,"interest_rate":12,"duration_months":12,"borrower_type":"business"}},{"path":"/special","full_url":"https://thue.cuthongthai.vn/api/tax/special","method":"POST","description":{"en":"Calculate Special Income Tax (Seasonal, Non-resident, Prize, Inheritance)","vi":"Tính thuế TNCN đặc biệt (Vãng lai, Không cư trú, Trúng thưởng, Thừa kế)"},"example_request":{"amount":50,"type":"prize"}},{"path":"/comparison","full_url":"https://thue.cuthongthai.vn/api/tax/comparison","method":"POST","description":{"en":"Compare HKD Tax Methods: % Revenue vs 15% Profit","vi":"So sánh phương pháp thuế HKD: % Doanh thu vs 15% Lợi nhuận"},"example_request":{"annual_revenue":1000,"category":"Service","expenses":600}},{"path":"/exemption","full_url":"https://thue.cuthongthai.vn/api/tax/exemption","method":"POST","description":{"en":"Check HKD Tax Exemption Eligibility (≤500M threshold)","vi":"Kiểm tra miễn thuế HKD (ngưỡng ≤500M)"},"example_request":{"annual_revenue":400,"business_start_date":"2025-06-01"}},{"path":"/api/risk/watchlist/search","full_url":"https://thue.cuthongthai.vn/api/risk/watchlist/search","method":"GET","description":{"en":"Search SME & Individual Tax Risk Watchlist (Article 100 Law on Tax Administration, NĐ 49/2025 Exit Ban, CV 1798/TCT-TTKT Invoice Fraud & Abandoned MST 03/06)","vi":"Tra cứu danh sách công khai Cá nhân/DN nợ thuế, tạm hoãn xuất cảnh (NĐ 49/2025) & DN rủi ro hóa đơn (CV 1798/TCT-TTKT, MST 03/06)"},"example_request":{"q":"0109881524","type":"company","source":"risky_tax_entity"}},{"path":"/api/risk/verify-partner","full_url":"https://thue.cuthongthai.vn/api/risk/verify-partner","method":"POST","description":{"en":"Verify SME Invoice Supplier (`invoice_purchase`) or Real Estate Seller (`real_estate`) Tax Risk under CV 1798/TCT-TTKT, NĐ 49/2025/NĐ-CP & Land Law 2024 Art. 45","vi":"Kiểm tra chéo rủi ro đối tác xuất hóa đơn SME/HKD hoặc bên bán BĐS (MST, Tên, CCCD)"},"example_request":{"tax_code":"0109881524","transaction_type":"invoice_purchase"}}],"reference_data":{"tax_year":2026,"effective_date":"2026-07-01","currency":"VND","unit":"million VND (triệu đồng)"}},"meta":{"source":"Finance Hub - Cú Thông Thái","documentation":"https://thue.cuthongthai.vn/docs/api","citation":"CuThongThai Finance Hub & Tax Risk Watchlist API v1.1 (https://thue.cuthongthai.vn)"}}