SNOMED Linking

Link SNOMED ID for the given text

GET /eka-mcp/linking/v1/snomed

Get SNOMED ID

cURL

curl --request GET \
  --url https://api.dev.eka.care/eka-mcp/linking/v1/snomed \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "snomed_id": "<string>",
    "text": "<string>",
    "confidence": 123
  }
]

Link multiple medical terms to their corresponding SNOMED CT (Systematized Nomenclature of Medicine Clinical Terms) codes.

Overview

This endpoint accepts an array of medical terms and returns their corresponding SNOMED CT identifiers along with confidence scores. SNOMED CT is a comprehensive clinical terminology that provides standardized codes for medical concepts.

Usage

Input Format

The text_to_link parameter accepts an array of medical terms or abbreviations:

curl --location --globoff 'https://api.eka.care/eka-mcp/linking/v1/snomed?text_to_link=["dm2", "htn"]'

Common Medical Abbreviations

• dm2 - Type 2 Diabetes Mellitus
• htn - Hypertension
• copd - Chronic Obstructive Pulmonary Disease
• mi - Myocardial Infarction
• chf - Congestive Heart Failure

Response Structure

Each linked term returns:

• snomed_id: The official SNOMED CT identifier
• text: The original text that was processed
• confidence: Confidence score of the mapping (0-1 scale)

Benefits

• Standardization: Convert medical abbreviations and terms to standardized SNOMED codes
• Interoperability: Enable data exchange between healthcare systems
• Clinical Decision Support: Support automated clinical reasoning and decision-making
• Batch Processing: Process multiple terms simultaneously for efficiency

Authorizations

Authorization · string · header · required

Enter JWT token

Query Parameters

text_to_link · string[] · required

Array of text strings to link to SNOMED codes (e.g., ["dm2", "htn"])

Response

200

application/json

OK

snomed_id · string · required

The SNOMED ID of the condition

text · string · required

The original text that was linked

confidence · number | null

Confidence score of the SNOMED linking