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.

GEThttps://apibox.io.vn/v1/hs-code/{code}

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

NameInTypeRequiredDefault
codepath|querystringnoHS code of 2, 4, 6 or 8 digits, dots optional (8471.30.20), in the path or as ?code=.
qquerystringnoSearch words (Vietnamese or English) or a code prefix; required when no code is given.
levelquerystringno8Search level: 2, 4, 6, 8 or any.
limitquerynumberno20Search results (1–50).

Example

curl "https://apibox.io.vn/v1/hs-code/8471.30.20" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

Start with 1,000 free requests every month. Get free API key →