Get SNOMED ID (Deprecated)
curl --request GET \
--url https://api.dev.eka.care/eka-mcp/linking/v1/snomed \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.dev.eka.care/eka-mcp/linking/v1/snomed"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.dev.eka.care/eka-mcp/linking/v1/snomed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.eka.care/eka-mcp/linking/v1/snomed",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.eka.care/eka-mcp/linking/v1/snomed"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dev.eka.care/eka-mcp/linking/v1/snomed")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.eka.care/eka-mcp/linking/v1/snomed")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"snomed_id": "<string>",
"text": "<string>",
"confidence": 123
}
]{
"error": "<string>"
}{
"error": "<string>"
}Ontology Linking (Deprecated)
SNOMED Linking (Deprecated)
deprecated
Deprecated. Use POST /med-link/nel/link from the Medical Entity Codification API instead — see the Link Entity docs. This endpoint remains operational for existing integrations.
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>'import requests
url = "https://api.dev.eka.care/eka-mcp/linking/v1/snomed"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.dev.eka.care/eka-mcp/linking/v1/snomed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dev.eka.care/eka-mcp/linking/v1/snomed",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dev.eka.care/eka-mcp/linking/v1/snomed"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dev.eka.care/eka-mcp/linking/v1/snomed")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dev.eka.care/eka-mcp/linking/v1/snomed")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"snomed_id": "<string>",
"text": "<string>",
"confidence": 123
}
]{
"error": "<string>"
}{
"error": "<string>"
}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 + path | GET /eka-mcp/linking/v1/snomed | POST /med-link/nel/link |
| Input | ?text_to_link=["dm2","htn"] (array in query string) | JSON body: { "query": "...", "ontology": "snomed", "version": "20250401_extended" } |
| Batch | Array of strings in one query param | Dedicated batch endpoint (up to 5 queries) |
| Result fields | snomed_id, text, confidence | term_id, term_name, score, is_linked, semantic tag + multilingual terms |
| Other ontologies | SNOMED only | SNOMED, LOINC, Medication, ICD-10-CM (Comprehend) |
# 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
Thetext_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
Enter JWT token
Query Parameters
Array of text strings to link to SNOMED codes (e.g., ["dm2", "htn"])
Was this page helpful?