> ## Documentation Index
> Fetch the complete documentation index at: https://ekacare-mintlify-80308f89.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SNOMED Linking (Deprecated)

> **Deprecated.** Use `POST /med-link/nel/link` from the Medical Entity Codification API instead — see the [Link Entity](/api-reference/health-ai/medical-entity-codification/link-entity) docs. This endpoint remains operational for existing integrations.

<Warning>
  **This endpoint is deprecated.** It remains operational for existing
  integrations but is no longer recommended for new work.

  Use the [**Link Entity**](/api-reference/health-ai/medical-entity-codification/link-entity)
  endpoint instead — part of the [**Medical Entity Codification**](/api-reference/health-ai/medical-entity-codification/overview)
  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)](/api-reference/health-ai/medical-entity-codification/link-entity-batch).
</Warning>

## Migrating to Medical Entity Codification

|                  | This endpoint (deprecated)                            | [Link Entity](/api-reference/health-ai/medical-entity-codification/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](/api-reference/health-ai/medical-entity-codification/link-entity-batch) (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)                                                                    |

Equivalent migration:

```bash theme={null}
# 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:

```bash theme={null}
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)


## OpenAPI

````yaml get /eka-mcp/linking/v1/snomed
openapi: 3.1.0
info:
  title: MCP Eka Assist API
  description: Eka Assist documentation
  version: 1.0.0
  contact:
    name: Nikhil
    url: https://eka.care/
    email: nikhil.kasukurthi@eka.care
servers:
  - url: https://api.dev.eka.care
    description: Staging Server
  - url: https://api.eka.care
    description: Prod Server
security:
  - BearerAuth: []
tags:
  - name: protocols
  - name: medications
  - name: pharmacology
  - name: snomed
paths:
  /eka-mcp/linking/v1/snomed:
    get:
      tags:
        - snomed
      summary: Get SNOMED ID (Deprecated)
      description: >-
        **Deprecated.** Use `POST /med-link/nel/link` from the Medical Entity
        Codification API instead — see the [Link
        Entity](/api-reference/health-ai/medical-entity-codification/link-entity)
        docs. This endpoint remains operational for existing integrations.
      parameters:
        - name: text_to_link
          in: query
          schema:
            type: array
            items:
              type: string
            description: >-
              Array of text strings to link to SNOMED codes (e.g., ["dm2",
              "htn"])
            title: Text to Link
          required: true
          description: Array of text strings to link to SNOMED codes (e.g., ["dm2", "htn"])
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SNOMEDLinkingList.a9993e3'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericErr.82b01e4'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericErr.82b01e4'
      deprecated: true
components:
  schemas:
    SNOMEDLinkingList.a9993e3:
      items:
        $ref: '#/components/schemas/SNOMEDLinkingList.a9993e3.SNOMEDLinking'
      title: SNOMEDLinkingList
      type: array
    GenericErr.82b01e4:
      properties:
        error:
          title: Error
          type: string
      required:
        - error
      title: GenericErr
      type: object
    SNOMEDLinkingList.a9993e3.SNOMEDLinking:
      properties:
        snomed_id:
          title: SNOMED Id
          type: string
          description: The SNOMED ID of the condition
        text:
          title: Text
          type: string
          description: The original text that was linked
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Confidence
          description: Confidence score of the SNOMED linking
      required:
        - snomed_id
        - text
      title: SNOMEDLinking
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter JWT token

````