Vietnam Label Rules API

Mandatory label content for goods sold in Vietnam (Decree 37/2026), 69 product groups, the Vietnamese sticker for imports, date rules and a label checker.

Parameters

Example

curl -X POST "https://apibox.io.vn/v1/vn-label-rules" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"cosmetics","origin":"import","label":{"name":"Serum dưỡng da","manufacturer":{"name":"ABC Cosmetics Co., Ltd","address":"Seoul, Korea"},"importer":{"name":"Công ty TNHH XYZ","address":"Hà Nội"},"origin":"Made in KR","quantity":"30 ml","ingredients":"Water, Glycerin","lot":"L2301","expiry":"01/05/2027","instructions":"Thoa lên da"}}'

const res = await fetch('https://apibox.io.vn/v1/vn-label-rules', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "group": "cosmetics",
    "origin": "import",
    "label": {
      "name": "Serum dưỡng da",
      "manufacturer": {
        "name": "ABC Cosmetics Co., Ltd",
        "address": "Seoul, Korea"
      },
      "importer": {
        "name": "Công ty TNHH XYZ",
        "address": "Hà Nội"
      },
      "origin": "Made in KR",
      "quantity": "30 ml",
      "ingredients": "Water, Glycerin",
      "lot": "L2301",
      "expiry": "01/05/2027",
      "instructions": "Thoa lên da"
    }
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-label-rules",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"group": "cosmetics", "origin": "import", "label": {"name": "Serum dưỡng da", "manufacturer": {"name": "ABC Cosmetics Co., Ltd", "address": "Seoul, Korea"}, "importer": {"name": "Công ty TNHH XYZ", "address": "Hà Nội"}, "origin": "Made in KR", "quantity": "30 ml", "ingredients": "Water, Glycerin", "lot": "L2301", "expiry": "01/05/2027", "instructions": "Thoa lên da"}},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-label-rules');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"group":"cosmetics","origin":"import","label":{"name":"Serum dưỡng da","manufacturer":{"name":"ABC Cosmetics Co., Ltd","address":"Seoul, Korea"},"importer":{"name":"Công ty TNHH XYZ","address":"Hà Nội"},"origin":"Made in KR","quantity":"30 ml","ingredients":"Water, Glycerin","lot":"L2301","expiry":"01/05/2027","instructions":"Thoa lên da"}}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "group": {
    "id": "cosmetics",
    "no": 14,
    "vi": "Mỹ phẩm",
    "en": "Cosmetics",
    "note": "The expiry date is mandatory when the product is stable for less than 30 months."
  },
  "origin": "import",
  "required_fields": [
    {
      "key": "name",
      "required": true,
      "vi": "Tên hàng hóa",
      "en": "Product name",
      "source": "Điều 42 khoản 1 điểm a"
    },
    {
      "key": "manufacturer",
      "required": true,
      "vi": "Tên, địa chỉ tổ chức, cá nhân sản xuất",
      "en": "Manufacturer name and address",
      "source": "Điều 42 khoản 1 điểm b, Điều 44 khoản 2"
    },
    "…"
  ],
  "check": {
    "valid": false,
    "missing": [
      {
        "field": "warnings",
        "vi": "Thông tin, cảnh báo",
        "en": "Warnings",
        "source": "Phụ lục I mục 14"
      }
    ],
    "invalid": [
      {
        "field": "origin",
        "value": "Made in KR",
        "issue": "\"KR\" looks like a country code: on the Vietnamese label the country name is not abbreviated (Điều 39 khoản 1); abbreviations per TCVN 7217-1 are only accepted on the original label of imports (Điều 42 khoản 2)"
      }
    ],
    "warnings": [],
    "present": [
      "name",
      "manufacturer",
      "importer",
      "origin",
      "quantity",
      "ingredients",
      "lot",
      "expiry",
      "instructions"
    ]
  },
  "aux_label_lines": [
    {
      "key": "name",
      "label": "Tên hàng",
      "value": "Serum dưỡng da"
    },
    {
      "key": "manufacturer",
      "label": "Nhà sản xuất",
      "value": "ABC Cosmetics Co., Ltd, Seoul, Korea"
    },
    {
      "key": "importer",
      "label": "Nhập khẩu và phân phối",
      "value": "Công ty TNHH XYZ, Hà Nội"
    },
    {
      "key": "origin",
      "label": "Xuất xứ",
      "value": "Hàn Quốc"
    },
    "…"
  ],
  "legal": {
    "decree": "Nghị định 37/2026/NĐ-CP (quy định chi tiết Luật Chất lượng sản phẩm, hàng hóa), Chương IV, Phụ lục I và III",
    "effective_from": "2026-01-23",
    "replaces": [
      "Nghị định 43/2017/NĐ-CP",
      "Nghị định 111/2021/NĐ-CP"
    ],
    "reviewed": "2026-11-11"
  },
  "disclaimer": "Reference summary, not legal advice; check the official text of Nghị định 37/2026/NĐ-CP and the specialised rules (drugs, food safety, cosmetics…)."
}

Use cases

• Prepare the Vietnamese sticker for imported cosmetics or food
• Check a product label before printing a new packaging run
• Validate seller listings on a marketplace for missing label data
• Map HS codes of a customs declaration to label requirements

FAQ

Related APIs