Vietnam Company Name Checker API

Check a proposed Vietnamese company name against the Law on Enterprises 2020 (arts. 37–41) and compare two names for duplicate or confusing similarity.

Parameters

Example

curl "https://apibox.io.vn/v1/vn-company-name?name=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long%202&compare_with=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-company-name?name=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long%202&compare_with=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long', {
  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/vn-company-name?name=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long%202&compare_with=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-company-name?name=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long%202&compare_with=C%C3%B4ng%20ty%20TNHH%20Ho%C3%A0ng%20Long');
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

{
  "name": "Công ty TNHH Hoàng Long 2",
  "type": {
    "key": "llc",
    "vi": "Công ty TNHH",
    "en": "Limited Liability Company"
  },
  "proper_name": "Hoàng Long 2",
  "valid": true,
  "errors": 0,
  "warnings": 0,
  "checks": [
    {
      "rule": "type_element",
      "ok": true,
      "severity": "info",
      "en": "Type of enterprise: Công ty TNHH.",
      "vi": "Loại hình doanh nghiệp: Công ty TNHH.",
      "legal": "Luật Doanh nghiệp 2020 Điều 37 khoản 1"
    },
    {
      "rule": "proper_name",
      "ok": true,
      "severity": "info",
      "en": "Proper name: \"Hoàng Long 2\".",
      "vi": "Tên riêng: \"Hoàng Long 2\".",
      "legal": "Luật Doanh nghiệp 2020 Điều 37 khoản 1"
    }
  ],
  "suggestions": {
    "english_name": "HOANG LONG 2 LIMITED LIABILITY COMPANY",
    "abbreviation": "HOANGLONG2 CO., LTD",
    "initials": "HL2"
  },
  "comparison": {
    "compare_with": "Công ty TNHH Hoàng Long",
    "proper_name_a": "Hoàng Long 2",
    "proper_name_b": "Hoàng Long",
    "verdict": "confusingly_similar",
    "cases": [
      {
        "case": "number_or_letter_suffix",
        "legal": "Điều 41 khoản 2 điểm d",
        "en": "Only differs by a number, ordinal or letter right after the proper name (\"2\").",
        "vi": "Tên riêng chỉ khác bởi số tự nhiên, số thứ tự hoặc một chữ cái ngay sau tên riêng (\"2\")."
      }
    ],
    "similarity": {
      "combined": 0.9083,
      "levenshtein": 0.8333,
      "jaro_winkler": 0.9667,
      "token_sort": 0.9091,
      "token_set": 1,
      "trigram": 0.8333
    },
    "normalized": [
      "hoang long 2",
      "hoang long"
    ]
  },
  "notes": [
    "This API does NOT search the National Business Registration Portal (dangkykinhdoanh.gov.vn): duplicates and confusing names can only be checked against names you send in compare_with. Check the portal before filing.",
    "Similarity (\"reads the same\") is a heuristic; the business registration office decides."
  ],
  "legal": [
    {
      "ref": "Luật Doanh nghiệp 2020 (59/2020/QH14), Điều 37–41",
      "effective_from": "2021-01-01",
      "note": "Not changed by Luật 76/2025/QH15 (from 2025-07-01)"
    },
    {
      "ref": "Nghị định 168/2025/NĐ-CP (đăng ký doanh nghiệp)",
      "effective_from": "2025-07-01"
    }
  ],
  "disclaimer": "Reference calculation, not legal advice; check the official text.",
  "disclaimer_vi": "Kết quả tham khảo, không phải tư vấn pháp lý; hãy đối chiếu văn bản chính thức.",
  "reviewed": "2026-11-11"
}

Use cases

• Pre-check names in a company formation service
• Warn customers that a name is too close to a known competitor
• Normalise company names (type + proper name) on invoices and in a CRM
• Suggest an English name and abbreviation for the registration form

FAQ

Related APIs