Vietnamese ICD-10 codes API

Look up Vietnamese ICD-10 codes of Thông tư 06/2026/TT-BYT: Vietnamese names, chapter / block tree, main-diagnosis rules, accent-free search, batch checks.

GETPOSThttps://apibox.io.vn/v1/vn-icd10

Data & JSON▶ Try it online

The Ministry of Health list of ICD-10 codes used in Vietnam since 01/07/2026 (Thông tư 06/2026/TT-BYT, appendix "Danh mục mã bệnh tật, nguyên nhân tử vong theo ICD-10", 15,844 codes): code=E11.9 (also E119 or the path /v1/vn-icd10/E11.9) returns the Vietnamese name, its category, the hierarchy (22 chapters, blocks and sub-blocks with their Vietnamese names), sub-codes, the dagger (†) / asterisk (*) mark and the usage rules of columns 24–29 of the appendix: not usable as the main diagnosis, discouraged as main diagnosis, not usable because a more specific 4- or 5-character code exists, cause of death only, female-only and male-only codes.

q=dai thao duong searches the Vietnamese names without accents (all words must match, codes by prefix), optionally within a chapter. codes=E11.9,I10,A00 checks up to 1,000 codes at once, as a claims or HIS validation would: unknown codes, codes that need a more specific subdivision, codes that cannot be the main diagnosis, and with sex=male|female sex-specific codes. chapter=IV or group=E10-E14 browses the tree.

Only the Vietnamese texts published in the circular are served (no WHO English descriptions, inclusion / exclusion notes are left out). The data is rebuilt weekly from the appendix PDF when it changes. This is a coding aid, not medical advice.

Parameters

Name	In	Type	Required	Default
`code`	query\|path	string	no		An ICD-10 code (`E11.9`, `E119`) or a chapter / block (`IV`, `E10-E14`).
`q`	query	string	no		Search the Vietnamese names (accents optional) or code prefixes.
`codes`	query\|body	string	no		Batch check, comma separated or array (max 1,000).
`sex`	query\|body	string	no		`male` / `female`: warn about sex-specific codes.
`chapter`	query	string	no		Browse a chapter (`I`…`XXII`), or limit `q` to it.
`group`	query	string	no		Browse a block or sub-block (`E10-E14`).
`limit`	query	number	no	`20`	Search results (max 200).

Example

curl "https://apibox.io.vn/v1/vn-icd10?code=E11.9" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-icd10?code=E11.9', {
  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-icd10?code=E11.9",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-icd10?code=E11.9');
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": "E11.9",
  "code_no_dot": "E119",
  "name_vi": "Bệnh đái tháo đường típ 2, không kèm biến chứng",
  "kind": "subcategory",
  "mark": null,
  "usable_for_coding": true,
  "main_diagnosis_allowed": true,
  "rules": [],
  "chapter": {
    "code": "E00-E90",
    "level": "chapter",
    "chapter": "IV",
    "name_vi": "Bệnh nội tiết, dinh dưỡng và chuyển hóa"
  },
  "hierarchy": [
    {
      "code": "E00-E90",
      "level": "chapter",
      "chapter": "IV",
      "name_vi": "Bệnh nội tiết, dinh dưỡng và chuyển hóa"
    },
    {
      "code": "E10-E14",
      "level": "block",
      "name_vi": "Đái tháo đường"
    }
  ],
  "category": {
    "code": "E11",
    "name_vi": "Bệnh đái tháo đường típ 2"
  },
  "source": "Thông tư 06/2026/TT-BYT, Phụ lục: Danh mục mã bệnh tật, nguyên nhân tử vong theo ICD-10",
  "legal_basis": "Thông tư 06/2026/TT-BYT ngày 02/04/2026 của Bộ Y tế (hiệu lực 01/07/2026)",
  "effective": "2026-07-01",
  "codes_in_list": 15844,
  "data_built": "2026-11-11",
  "note": "Vietnamese names as published in the appendix of the circular. Coding rules: QĐ 1849/QĐ-BYT (2026) technical guidance."
}

Use cases

Diagnosis code picker with Vietnamese search in a clinic or HIS app
Validate ICD-10 codes before sending BHYT claims (XML 130)
Show the Vietnamese disease name for codes in reports
Browse ICD-10 chapters and blocks in medical training apps

FAQ

Which edition is it?

The list of Thông tư 06/2026/TT-BYT (issued 02/04/2026, in force 01/07/2026), which replaces the list of QĐ 4469/QĐ-BYT (2020). Each answer names the source.

What does "main_diagnosis_allowed: false" mean?

The circular marks the code as not usable (or a more specific code is required, or cause of death only) or as an asterisk manifestation code, so it cannot be the main diagnosis (bệnh chính).

Are English names included?

No. Only the Vietnamese names of the legal document are served; the WHO English descriptions are not redistributed.

Related APIs

{✓}

Vietnamese ICD-10 codes API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON