Skip to main content
GET
/
eka-mcp
/
linking
/
v1
/
snomed
Get SNOMED ID (Deprecated)
curl --request GET \
  --url https://api.dev.eka.care/eka-mcp/linking/v1/snomed \
  --header 'Authorization: Bearer <token>'
[
  {
    "snomed_id": "<string>",
    "text": "<string>",
    "confidence": 123
  }
]
This endpoint is deprecated. It remains operational for existing integrations but is no longer recommended for new work.Use the Link Entity endpoint instead — part of the Medical Entity Codification API. It covers SNOMED CT (plus LOINC, medication and ICD-10-CM) with a richer result model — confidence scores, is_linked, semantic tags, multilingual term matches, and batched lookups via Link Entity (Batch).

​
Migrating to Medical Entity Codification

This endpoint (deprecated)Link Entity
Method + pathGET /eka-mcp/linking/v1/snomedPOST /med-link/nel/link
Input?text_to_link=["dm2","htn"] (array in query string)JSON body: { "query": "...", "ontology": "snomed", "version": "20250401_extended" }
BatchArray of strings in one query paramDedicated batch endpoint (up to 5 queries)
Result fieldssnomed_id, text, confidenceterm_id, term_name, score, is_linked, semantic tag + multilingual terms
Other ontologiesSNOMED onlySNOMED, LOINC, Medication, ICD-10-CM (Comprehend)
Equivalent migration: 
# Old (deprecated)
curl --location --globoff \
  'https://api.eka.care/eka-mcp/linking/v1/snomed?text_to_link=["dm2","htn"]' \
  --header 'Authorization: Bearer <token>'

# New
curl --location 'https://api.eka.care/med-link/nel/link' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "dm2",
    "ontology": "snomed",
    "version": "20250401_extended",
    "top_k": 3
  }'

​
Legacy endpoint reference

The remainder of this page documents the deprecated endpoint as it stands today for integrators who have not yet migrated. Link multiple medical terms to their corresponding SNOMED CT (Systematized Nomenclature of Medicine Clinical Terms) codes.

​
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)

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

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