Kiểm tra tên doanh nghiệp API

Kiểm tra tên công ty dự kiến theo Luật Doanh nghiệp 2020 (Điều 37–41) và so sánh hai tên để phát hiện trùng hoặc gây nhầm lẫn.

Tham số

Ví dụ

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));

Kết quả trả về

{
  "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"
}

Ứng dụng

• Kiểm tra sơ bộ tên trong dịch vụ thành lập doanh nghiệp
• Cảnh báo khách hàng khi tên quá giống đối thủ đã biết
• Chuẩn hoá tên công ty (loại hình + tên riêng) trên hoá đơn, CRM
• Gợi ý tên tiếng Anh và tên viết tắt cho hồ sơ đăng ký

Hỏi đáp

API liên quan