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

# SNOMED Linking

> Link SNOMED ID for the given text

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:

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

## 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


## 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
      description: Link SNOMED ID for the given text
      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'
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

````