The ICD-11 endpoints expose codes from two chapters of the International Classification of Diseases, 11th Revision: Traditional Medicine Module 2 (TM2, codes prefixedDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/sagar-grv/ayush-synapse/llms.txt
Use this file to discover all available pages before exploring further.
TM2-) and Biomedicine (codes prefixed BM-). In the current MVP, six sample codes per chapter are returned by the WhoApiService. Production deployments can integrate directly with the WHO ICD-11 API by supplying a valid WHO_API_KEY environment variable.
GET /icd11 — List All ICD-11 Codes
Returns the combined set of TM2 and Biomedicine codes in a single array. Method:GETPath:
/icd11Auth: None required (open in demo mode)
Response
Returns a JSON array containing TM2 objects followed by Biomedicine objects.Unique ICD-11 code identifier, e.g.
TM2-001 or BM-001.Human-readable code name, e.g.
Common Cold.Clinical definition text, e.g.
Acute viral rhinitis.ICD-11 chapter this code belongs to. Either
TM2 or Biomedicine.Example
Response
GET /icd11/tm2 — List TM2 Codes
Returns only the codes that belong to the Traditional Medicine Module 2 chapter (chapter = "TM2").
Method: GETPath:
/icd11/tm2Auth: None required (open in demo mode)
Response
Same object shape asGET /icd11. All returned objects will have "chapter": "TM2".
Example
Response
GET /icd11/biomedicine — List Biomedicine Codes
Returns only the codes that belong to the Biomedicine chapter (chapter = "Biomedicine").
Method: GETPath:
/icd11/biomedicineAuth: None required (open in demo mode)
Response
Same object shape asGET /icd11. All returned objects will have "chapter": "Biomedicine".
Example
Response
GET /icd11/search/{term} — Search ICD-11 Codes
Performs a case-insensitive substring search across thecode, display, and definition fields of all ICD-11 codes (both TM2 and Biomedicine).
Method: GETPath:
/icd11/search/{term}Auth: None required (open in demo mode)
Rate limit: 30 requests per minute per IP address
Path Parameters
The search term to match against code identifiers, display names, and definitions. For example,
fever matches TM2-003 Fever and BM-003 Fever of unknown origin.Response
Returns a filtered JSON array of code objects that contain the search term in at least one of the three searchable fields. Returns an empty array[] if no matches are found.
ICD-11 code identifier.
Human-readable code name.
Clinical definition text.
TM2 or Biomedicine.Example — Search for “fever”
Response
GET /icd11/{code} — Get a Specific ICD-11 Code
Returns the full detail record for a single ICD-11 code. Method:GETPath:
/icd11/{code}Auth: None required (open in demo mode)
Path Parameters
The ICD-11 code identifier to retrieve. Must be an exact match, e.g.
TM2-001 or BM-004. The lookup searches both TM2 and Biomedicine code sets.Response
Returns a single code object on success, or HTTP 404 when the code is not found.ICD-11 code identifier.
Human-readable code name.
Clinical definition text.
TM2 or Biomedicine.404 Response
Example
Response — TM2-003
Response — BM-005
In the current MVP,
WhoApiService returns 6 sample TM2 codes (TM2-001 – TM2-006) and 6 sample Biomedicine codes (BM-001 – BM-006). These are returned directly without a live network call. To integrate with the real WHO ICD-11 API, set the WHO_API_KEY environment variable. The service connects to https://icd.who.int/dev11 and passes the key via an API-Key header on each request.