Vietnam HS Codes & Tariffs API
Look up or search Vietnam’s 2026 HS codes (AHTN 2022) with MFN and preferential import duty, VAT, export duty, excise, FTA rates and policies.
The HS code API serves Vietnam’s import-export nomenclature (AHTN 2022, Thông tư 31/2022/TT-BTC): 11,414 eight-digit tariff lines with their chapters, headings and subheadings. A line gives the Vietnamese and English description, unit, normal and MFN import duty, VAT, export duty, special consumption and environmental tax, the preferential rates of every free trade agreement (ATIGA, ACFTA, CPTPP, EVFTA, UKVFTA, RCEP by partner group…) and the policies attached to the code (licences, specialised inspections). A VAT value such as 8/10 means 10%, reduced to 8% under the VAT-reduction decree.
Look up a code in the path (/v1/hs-code/8471.30.20, dots optional) or with ?code=: 2, 4 and 6-digit codes return the description, hierarchy, children and number of lines. Search with ?q= in Vietnamese or English (máy tính xách tay, laptop, cà phê rang), with or without accents (accents count when you type them: bia ≠ bìa), or by code prefix (q=8517); level chooses 2, 4, 6, 8 or any.
Data comes from the 2026 “Biểu thuế xuất nhập khẩu” workbook compiled from the customs tariff and published by Trung tâm WTO và Hội nhập – VCCI (trungtamwto.vn), refreshed weekly, with manual overrides for later decrees. It is a lookup aid with no legal value: check the legal texts before declaring goods.
Parameters
| Name | In | Type | Required | Default | |
|---|---|---|---|---|---|
code | path|query | string | no | HS code of 2, 4, 6 or 8 digits, dots optional (8471.30.20), in the path or as ?code=. | |
q | query | string | no | Search words (Vietnamese or English) or a code prefix; required when no code is given. | |
level | query | string | no | 8 | Search level: 2, 4, 6, 8 or any. |
limit | query | number | no | 20 | Search results (1–50). |
Example
curl "https://apibox.io.vn/v1/hs-code/8471.30.20" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/hs-code/8471.30.20', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/hs-code/8471.30.20",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/hs-code/8471.30.20');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Response
{
"code": "84713020",
"level": 8,
"description_vi": "Máy tính xách tay kể cả notebook và subnotebook",
"description_en": "Laptops including notebooks and subnotebooks",
"unit": "chiếc",
"unit_en": "unit",
"normal_rate": 5,
"mfn_rate": 0,
"vat": "8/10",
"vat_reduction": null,
"export_rate": null,
"special_consumption_tax": null,
"environmental_tax": null,
"fta": {
"ACFTA": 0,
"ATIGA": 0,
"AJCEP": 0,
"VJEPA": 0,
"AKFTA": 0,
"AANZFTA": 0,
"AIFTA": 0,
"VKFTA": 0,
"VCFTA": 0,
"VN-EAEU": "*",
"CPTPP": 0,
"AHKFTA": 0,
"EVFTA": 0,
"UKVFTA": 0,
"VN-LAO": 0,
"VIFTA": 0,
"RCEPT": {
"A": 0,
"B": 0,
"C": 0,
"D": 0,
"E": 0,
"F": 0
}
},
"policies": "Hàng tiêu dùng QSD cấp NK (08/2023/TT-BCT - PL1.I); KTCN về hiệu suất năng lượng và dán nhãn năng lượng (1725/QĐ-BCT 2024); SP CNTT ĐQSD cấm NK (11/2018/TT-BTTTT); SPHH lĩnh vực CNTT và VT bắt buộc phải công bố hợp quy (29/2025/TT-BKHCN-PL2)",
"parent": "847130",
"path_vi": "Máy xử lý dữ liệu tự động và các khối chức năng của chúng; … > Máy xử lý dữ liệu tự động loại xách tay, có khối lượng không quá 10 kg, … > Máy tính xách tay kể cả notebook và subnotebook",
"path_en": "Automatic data processing machines and units thereof; … > Portable automatic data processing machines, weighing not more than 10 kg, … > Laptops including notebooks and subnotebooks",
"code_formatted": "8471.30.20",
"hierarchy": [
{
"code": "84",
"level": 2,
"description_vi": "Lò phản ứng hạt nhân, nồi hơi, máy và thiết bị cơ khí; các bộ phận của chúng",
"description_en": "Nuclear reactors, boilers, machinery and mechanical appliances; parts thereof"
},
{
"code": "847130",
"level": 6,
"description_vi": "Máy xử lý dữ liệu tự động loại xách tay, có khối lượng không quá 10 kg, gồm ít nhất một đơn vị xử lý dữ liệu trung tâm, một bàn phím và một màn hình:",
"description_en": "Portable automatic data processing machines, weighing not more than 10 kg, consisting of at least a central processing unit, a keyboard and a display:"
}
],
"chapter_98": [],
"data_version": "2026-33303fdd33",
"tariff_year": 2026,
"source": "Biểu thuế xuất nhập khẩu Việt Nam (Trung tâm WTO và Hội nhập – VCCI, trungtamwto.vn)",
"source_page": "https://trungtamwto.vn/chuyen-de/31581-bieu-thue-xuat-nhap-khau-viet-nam-nam-2026",
"note": "Lookup aid compiled from the customs tariff workbook; check the decree texts before declaring goods. VAT \"8/10\" = 10%, reduced to 8% where the reduction applies.",
"rcept_groups": {
"A": "ASEAN",
"B": "Australia",
"C": "China",
"D": "Japan",
"E": "Korea",
"F": "New Zealand"
}
}
Use cases
- HS code pickers in customs and logistics software
- Estimate import duty and VAT for a product
- Compare FTA rates to choose the origin of goods
- Check the licences and inspections required for a code
FAQ
What does VAT "8/10" mean?
10% VAT, reduced to 8% for the goods covered by the current VAT-reduction decree.
How current is the data?
The 2026 workbook is checked every week; data_version and the source page are in every answer, and later decrees are applied as manual overrides.
Can I use the result in a customs declaration?
It is a lookup aid. Classification and rates must be confirmed against the legal texts and, if needed, with customs.
Related APIs
JSON Validator
Check JSON syntax with exact line and column of errors, and validate data against a JSON Schema (draft 4, 7, 2019-09 or 2020-12).
{ }JSON Formatter
Pretty print JSON with 0-8 spaces or tabs, minify it, or sort object keys recursively. Syntax errors are reported with line and column.
CSVCSV to JSON
Convert CSV into an array of JSON objects using the header row, with delimiter auto-detection, number and boolean typing, and row-level errors.