ICD11 Medical Coding
On this page
Purpose
ICD11 Medical Coding sends a short diagnosis or condition phrase to the WHO ICD-11 MMS search and returns candidate codes in WHO response order. Each candidate can include its code, title, score, definition, synonyms, inclusion and exclusion terms, and browser URL.
It helps a reviewer find candidates. It does not extract a diagnosis from a long note, choose a final code, validate billing rules, or make a diagnosis.
When to use it
- Look up ICD-11 candidates for a concise diagnosis or symptom phrase.
- Give an Agent an ICD-11 lookup tool during a coding-assistance conversation.
- Compare several candidates for an ambiguous phrase.
- Retrieve localized labels for a supported WHO language.
Required setup
You do not enter a key in this component. The Arkus installation must have platform-managed WHO ICD API credentials.
The full trimmed query is sent to WHO and appears in the output. Use a de-identified phrase without patient identifiers.
How to use it
In Tool Mode:
- Connect the component tool to Agent Core.
- Keep Search Mode set to strict and Top Results set to 3.
- Ask the Agent to look up one concise, de-identified diagnosis or symptom phrase.
- Have a reviewer confirm the code, title, inclusions, exclusions, compound details, and WHO browser URL.
For example, ask for candidates for "type 2 diabetes mellitus" rather than sending a full clinical note.
In Normal mode, enter the query directly and read the candidates from the Message output.
Configuration
| Setting | What it controls | Recommended starting point |
|---|---|---|
| Query | The phrase sent to WHO | Use one concise, de-identified condition or symptom phrase |
| Search Mode | Whether WHO flexisearch is used | Start with strict and switch to flexible only when needed |
| Top Results | The number of WHO candidates returned | Start with 3; the allowed range is 1 to 10 |
| Language | The response language | Use the language needed by the reviewer |
Expected result
The standard Message output is fenced JSON. Agent tool use returns the same structured result as a dictionary.
The component keeps WHO response order. It does not rank or re-rank candidates. A zero-result search returns an empty matches list. If one detail lookup fails, the candidate remains with a generic detail error.
Reference details
English is the default. The component supports 15 language choices. WHO lists German as prerelease and Latin as titles only for the current supported release.
Use Anonymisation to remove selected English PII before the WHO request. Chat Input can provide a Normal-mode query, and Chat Output can display the Message result.