Mã bệnh ICD-10 API
Tra mã bệnh ICD-10 theo Thông tư 06/2026/TT-BYT: tên tiếng Việt, cây chương / nhóm, quy tắc mã bệnh chính, tìm không dấu, kiểm tra hàng loạt mã.
Danh mục mã bệnh ICD-10 của Bộ Y tế áp dụng từ 01/07/2026 (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", 15.844 mã): code=E11.9 (hoặc E119, hoặc đường dẫn /v1/vn-icd10/E11.9) trả về tên tiếng Việt, nhóm bệnh 3 ký tự, cây phân cấp (22 chương, khối và tiểu khối kèm tên tiếng Việt), các mã con, dấu dao (†) / dấu sao (*) và quy tắc của các cột 24–29 trong phụ lục: mã không được dùng là bệnh chính, không khuyến khích dùng là bệnh chính, không được dùng vì có mã 4 hoặc 5 ký tự cụ thể hơn, chỉ dùng mã hóa nguyên nhân tử vong, mã chỉ có ở nữ, ở nam.
q=dai thao duong tìm trong tên tiếng Việt không cần dấu (mọi từ phải khớp, mã tìm theo tiền tố), có thể giới hạn theo chapter. codes=E11.9,I10,A00 kiểm tra tới 1.000 mã một lần như bước kiểm tra hồ sơ giám định hoặc HIS: mã không có trong danh mục, mã phải dùng mã chi tiết hơn, mã không được làm bệnh chính, và với sex=male|female thì cả mã theo giới tính. chapter=IV hoặc group=E10-E14 để duyệt cây.
Chỉ phục vụ phần tiếng Việt công bố trong thông tư (không có mô tả tiếng Anh của WHO, bỏ phần ghi chú bao gồm / loại trừ). Dữ liệu được dựng lại hằng tuần từ file PDF phụ lục khi có thay đổi. Đây là công cụ hỗ trợ mã hóa, không phải tư vấn y khoa.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
code | query|path | string | không | Mã ICD-10 (E11.9, E119) hoặc chương / khối (IV, E10-E14). | |
q | query | string | không | Tìm theo tên tiếng Việt (có dấu hoặc không) hoặc tiền tố mã. | |
codes | query|body | string | không | Kiểm tra hàng loạt, cách nhau bởi dấu phẩy hoặc mảng (tối đa 1.000). | |
sex | query|body | string | không | male / female: cảnh báo mã theo giới tính. | |
chapter | query | string | không | Duyệt một chương (I…XXII), hoặc giới hạn q trong chương. | |
group | query | string | không | Duyệt một khối hoặc tiểu khối (E10-E14). | |
limit | query | number | không | 20 | Số kết quả tìm kiếm (tối đa 200). |
Ví dụ
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));Kết quả trả về
{
"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."
}
Ứng dụng
- Chọn mã chẩn đoán, tìm tiếng Việt không dấu trong phần mềm phòng khám, HIS
- Kiểm tra mã ICD-10 trước khi gửi hồ sơ giám định BHYT (XML 130)
- Hiển thị tên bệnh tiếng Việt cho mã trong báo cáo
- Duyệt chương, nhóm ICD-10 trong app đào tạo y khoa
Hỏi đáp
Đây là phiên bản nào?
Danh mục của Thông tư 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026), thay danh mục kèm QĐ 4469/QĐ-BYT (2020). Mỗi kết quả đều ghi nguồn.
"main_diagnosis_allowed: false" nghĩa là gì?
Thông tư đánh dấu mã không được dùng (hoặc phải dùng mã chi tiết hơn, hoặc chỉ cho nguyên nhân tử vong) hay đây là mã dấu sao (biểu hiện), nên không được ghi là bệnh chính.
Có tên tiếng Anh không?
Không. Chỉ phục vụ tên tiếng Việt trong văn bản pháp luật; mô tả tiếng Anh của WHO không được phân phối lại.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.