ICD-11 Integration

AyushBridge provides seamless integration with WHO ICD-11 classifications, enabling dual-coding between traditional medicine systems and international standards.

ICD-11 Overview

The International Classification of Diseases 11th Revision (ICD-11) is the World Health Organization's latest global standard for health information and statistics. For traditional medicine integration, AyushBridge specifically works with:

Key Components

Traditional Medicine Module 2 (TM2): 529 disorder categories and 196 pattern codes
Biomedicine Classifications: Standard ICD-11 disease classifications
Cross-References: Bidirectional mappings between systems

Benefits of ICD-11 Integration

Global Interoperability: International health data exchange
Insurance Claims: Standardized coding for reimbursement
Research: Comparative effectiveness studies
Public Health: Population health monitoring

Traditional Medicine Module 2

ICD-11 TM2 provides standardized coding for traditional medicine disorders and patterns.

TM2 Structure

TM2 Root Categories:
├── TM26 - Disorders of vata dosha
├── TM27 - Disorders of pitta dosha  
├── TM28 - Disorders of kapha dosha
├── TM29 - Disorders of wind pattern
├── TM30 - Disorders of fire pattern
├── TM31 - Disorders of earth pattern
└── TM32 - Disorders of water pattern

Code Examples

ICD-11 TM2 Code	Display	Traditional System
`TM26.0`	Disorders of vata dosha	Ayurveda
`TM27.1`	Disorders of pitta dosha	Ayurveda
`TM28.2`	Disorders of kapha dosha	Ayurveda
`TM29.0`	Disorders of wind pattern	Traditional Chinese Medicine
`TM30.1`	Disorders of fire pattern	Traditional Chinese Medicine

FHIR CodeSystem Resource

{
  "resourceType": "CodeSystem",
  "url": "http://id.who.int/icd/release/11/mms",
  "version": "2022",
  "name": "ICD11TM2",
  "title": "ICD-11 Traditional Medicine Module 2",
  "status": "active",
  "content": "fragment",
  "filter": [
    {
      "code": "concept",
      "description": "Filter by TM2 concepts",
      "value": "TM"
    }
  ]
}

Biomedicine Integration

Integration with standard ICD-11 biomedicine classifications enables comprehensive dual-coding.

Common Biomedicine Mappings

Traditional Medicine	ICD-11 Biomedicine	Description
Amavata (NAM001)	FA20.00	Rheumatoid arthritis, unspecified
Jwara (NAM015)	MG2Y	Fever, unspecified
Prameha (NAM028)	5A11	Type 2 diabetes mellitus
Kasa (NAM042)	MD12	Cough

Triple Coding Example

For comprehensive coverage, conditions can be coded with:

NAMASTE Code: Traditional medicine terminology
ICD-11 TM2: Traditional medicine international standard
ICD-11 Bio: Biomedicine international standard

{
  "code": {
    "coding": [
      {
        "system": "https://ayush.gov.in/fhir/CodeSystem/namaste",
        "code": "NAM001",
        "display": "Amavata"
      },
      {
        "system": "http://id.who.int/icd/release/11/mms",
        "code": "TM26.0",
        "display": "Disorders of vata dosha"
      },
      {
        "system": "http://id.who.int/icd/release/11/mms",
        "code": "FA20.00",
        "display": "Rheumatoid arthritis, unspecified"
      }
    ]
  }
}

Code Mapping

AyushBridge maintains ConceptMap resources for bidirectional translation between coding systems.

Mapping Confidence Levels

Equivalent (1.0): Exact semantic match
Narrower (0.9): Source is narrower than target
Broader (0.8): Source is broader than target
Inexact (0.7): Approximate match
Unmatched (0.0): No suitable mapping

ConceptMap Resource Example

{
  "resourceType": "ConceptMap",
  "id": "namaste-to-icd11-tm2",
  "url": "https://ayushbridge.in/fhir/ConceptMap/namaste-to-icd11-tm2",
  "version": "1.0.0",
  "name": "NAMASTEToICD11TM2",
  "status": "active",
  "sourceUri": "https://ayush.gov.in/fhir/CodeSystem/namaste",
  "targetUri": "http://id.who.int/icd/release/11/mms",
  "group": [
    {
      "source": "https://ayush.gov.in/fhir/CodeSystem/namaste",
      "target": "http://id.who.int/icd/release/11/mms",
      "element": [
        {
          "code": "NAM001",
          "display": "Amavata",
          "target": [
            {
              "code": "TM26.0",
              "display": "Disorders of vata dosha",
              "equivalence": "equivalent",
              "comment": "Direct mapping - both refer to vata dosha disorders"
            }
          ]
        }
      ]
    }
  ]
}

Synchronization

AyushBridge maintains real-time synchronization with the WHO ICD-11 API to ensure up-to-date classifications.

Sync Process

Scheduled Updates: Daily synchronization at 2 AM UTC
Delta Processing: Only new/changed codes are updated
Version Control: Track ICD-11 release versions
Conflict Resolution: Automated merge strategies
Audit Logging: Complete sync operation trails

Sync Configuration

{
  "icd11Sync": {
    "apiUrl": "https://id.who.int/icd/release/11",
    "schedule": "0 2 * * *",
    "modules": ["mms", "tm2"],
    "batchSize": 100,
    "retryAttempts": 3,
    "authRefreshInterval": "55m"
  }
}

Manual Sync Trigger

curl -X POST "https://api.ayushbridge.in/admin/sync/icd11" \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"modules": ["tm2", "mms"], "force": true}'

Usage Examples

Lookup ICD-11 TM2 Code

curl -X GET "https://api.ayushbridge.in/fhir/CodeSystem/icd11/\$lookup?code=TM26.0" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/fhir+json"

Translate NAMASTE to ICD-11

curl -X POST "https://api.ayushbridge.in/fhir/ConceptMap/namaste-to-icd11/\$translate" \
  -H "Content-Type: application/fhir+json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "resourceType": "Parameters",
    "parameter": [
      {"name": "code", "valueCode": "NAM001"},
      {"name": "system", "valueUri": "https://ayush.gov.in/fhir/CodeSystem/namaste"},
      {"name": "target", "valueUri": "http://id.who.int/icd/release/11/mms"}
    ]
  }'

Search ICD-11 TM2 Codes

curl -X GET "https://api.ayushbridge.in/fhir/ValueSet/icd11-tm2/\$expand?filter=vata&count=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

Create Triple-Coded Condition

const createTripleCodedCondition = async (patientId, codes, token) => {
  const condition = {
    resourceType: 'Condition',
    subject: { reference: `Patient/${patientId}` },
    code: {
      coding: [
        {
          system: 'https://ayush.gov.in/fhir/CodeSystem/namaste',
          code: codes.namaste.code,
          display: codes.namaste.display
        },
        {
          system: 'http://id.who.int/icd/release/11/mms',
          code: codes.tm2.code,
          display: codes.tm2.display
        },
        {
          system: 'http://id.who.int/icd/release/11/mms',
          code: codes.biomedicine.code,
          display: codes.biomedicine.display
        }
      ]
    },
    clinicalStatus: {
      coding: [{
        system: 'http://terminology.hl7.org/CodeSystem/condition-clinical',
        code: 'active'
      }]
    },
    meta: {
      tag: [
        {
          system: 'https://ayushbridge.in/fhir/CodeSystem/coding-type',
          code: 'triple-coded',
          display: 'Triple-coded condition'
        }
      ]
    }
  };

  const response = await fetch('https://api.ayushbridge.in/fhir/Condition', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/fhir+json',
      'Authorization': `Bearer ${token}`
    },
    body: JSON.stringify(condition)
  });
  
  return await response.json();
};

Learn about WHO Ayurveda terminologies