Free public API for Vietnam tax calculations • 12 endpoints • 100 free calls/day
Base URL: https://thue.cuthongthai.vn/api/tax
cURL:
curl -X POST https://thue.cuthongthai.vn/api/tax/personal-income \
-H "Content-Type: application/json" \
-d '{"salary": 30, "dependents": 1}'JavaScript (fetch):
const response = await fetch('https://thue.cuthongthai.vn/api/tax/personal-income', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ salary: 30, dependents: 1 })
});
const data = await response.json();
console.log(data);Python (requests):
import requests
response = requests.post(
'https://thue.cuthongthai.vn/api/tax/personal-income',
json={'salary': 30, 'dependents': 1}
)
print(response.json())/api/tax/personal-income
Thuế TNCN
/api/tax/business-household
Thuế HKD
/api/tax/social-insurance
BHXH/BHYT/BHTN
/api/tax/investment
Thuế Đầu Tư
/api/tax/rental
Thuế Cho Thuê
/api/tax/ecommerce
Thuế TMĐT
/api/tax/personal-incomeCalculate personal income tax using Vietnam's 5-bracket progressive system (2026)
| Name | Type | Required | Description |
|---|---|---|---|
| salary | number | ✅ | Monthly gross salary (million VND) |
| bonus | number | ❌ | Monthly bonus (million VND) |
| allowance | number | ❌ | Monthly allowance (million VND) |
| dependents | number | ❌ | Number of dependents (default: 0) |
{
"salary": 30,
"bonus": 5,
"allowance": 2,
"dependents": 1
}{
"success": true,
"data": {
"gross_income": 37,
"taxable_income": 9.315,
"tax_amount": 0.4658,
"net_income": 33.0343
}
}/api/tax/business-householdCalculate tax for Hộ Kinh Doanh based on revenue and business category
| Name | Type | Required | Description |
|---|---|---|---|
| annual_revenue | number | ✅ | Annual revenue (million VND) |
| business_category | string | ✅ | Category: goods | services | food | construction | transport | production |
{
"annual_revenue": 800,
"business_category": "services"
}{
"success": true,
"data": {
"annual_revenue": 800,
"threshold_status": "taxable",
"vat": 72.727,
"pit": 40,
"license_fee": 1,
"total_tax": 113.727
}
}/api/tax/investmentCalculate tax on investment income: dividends, bonds, stocks, savings
| Name | Type | Required | Description |
|---|---|---|---|
| type | string | ✅ | Type: dividend | corporate_bond | government_bond | stock_transfer | savings |
| amount | number | ✅ | Amount (million VND) |
{
"type": "dividend",
"amount": 100
}{
"success": true,
"data": {
"type": "dividend",
"amount": 100,
"tax_rate": 5,
"tax": 5,
"net": 95
}
}/api/tax/rentalCalculate tax for rental income from real estate or vehicles
| Name | Type | Required | Description |
|---|---|---|---|
| annual_revenue | number | ✅ | Annual rental revenue (million VND) |
| has_services | boolean | ❌ | Whether includes additional services |
| property_count | number | ❌ | Number of properties |
{
"annual_revenue": 600,
"has_services": false,
"property_count": 1
}{
"success": true,
"data": {
"threshold": "taxable",
"vat": 30,
"pit": 30,
"total_tax": 60,
"net": 540
}
}/api/tax/ecommerceCalculate tax for e-commerce sellers (Shopee, Lazada, TikTok Shop)
| Name | Type | Required | Description |
|---|---|---|---|
| platform_revenue | number | ✅ | Platform revenue (million VND) |
| offline_revenue | number | ❌ | Offline revenue (million VND) |
| product_type | string | ✅ | Type: Goods | Services | Food | Digital |
{
"platform_revenue": 800,
"offline_revenue": 100,
"product_type": "Goods"
}{
"success": true,
"data": {
"total_revenue": 900,
"withheld_tax": 8,
"refund_eligible": false
}
}/api/tax/overtimeCalculate overtime pay with tax-exempt portion
/api/tax/lendingCalculate P2P lending income tax (10%)
/api/tax/specialSpecial income tax: seasonal, prize, inheritance
/api/tax/comparisonCompare HKD tax methods
/api/tax/exemptionCheck HKD tax exemption eligibility
/api/taxAPI index with all endpoints
BUSINESS
10,000 calls/day
$300/month
Coming SoonENTERPRISE
Unlimited
Custom pricing
Contact UsTo access higher rate limits, create a free API key:
curl -X POST https://thue.cuthongthai.vn/api/tax/personal-income \
-H "Authorization: Bearer ctt_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"salary": 30}'When using our API, please cite as:
According to Finance Hub - Cú Thông Thái Tax API, [your data here] as of [date]. Source: https://thue.cuthongthai.vn/api/tax API Documentation: https://thue.cuthongthai.vn/docs/api
/api/tax/social-insuranceSocial Insurance (BHXH/BHYT/BHTN)
Calculate social, health, and unemployment insurance contributions
Parameters:
Request Example:
{ "salary": 15, "type": "both" }Response Example:
{ "success": true, "data": { "employee_contribution": { "bhxh": 1.2, "bhyt": 0.225, "bhtn": 0.15, "total": 1.575 }, "employer_contribution": { "bhxh": 2.55, "bhyt": 0.45, "bhtn": 0.15, "total": 3.15 }, "total": 4.725 } }