> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omophub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Concept Mappings

## Overview

Retrieve all mappings from a concept to equivalent or related concepts in other vocabulary systems.

## Path Parameters

<ParamField path="concept_id" type="integer" required>
  The OMOP concept ID to get mappings for
</ParamField>

## Query Parameters

<ParamField query="target_vocabulary" type="string">
  Filter mappings to a specific target vocabulary (e.g., "ICD10CM", "SNOMED")
</ParamField>

<ParamField query="include_invalid" type="boolean" default="true">
  Include invalid/deprecated mappings in results
</ParamField>

<ParamField query="vocab_release" type="string">
  Specific vocabulary release version to use (e.g., "2025.1", "2024.2").
  When not specified, uses the default/latest vocabulary version.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  Contains the mapping results

  <Expandable title="data">
    <ResponseField name="mappings" type="array">
      Array of concept mappings

      <Expandable title="mappings">
        <ResponseField name="source_concept_id" type="integer">
          OMOP concept ID of the source concept
        </ResponseField>

        <ResponseField name="source_concept_name" type="string">
          Name of the source concept
        </ResponseField>

        <ResponseField name="target_concept_id" type="integer">
          OMOP concept ID of the mapped target concept
        </ResponseField>

        <ResponseField name="target_concept_name" type="string">
          Name of the target concept
        </ResponseField>

        <ResponseField name="relationship_id" type="string">
          Type of relationship (e.g., "Maps to")
        </ResponseField>

        <ResponseField name="confidence" type="number">
          Confidence score for the mapping (0.0 to 1.0)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Response metadata

  <Expandable title="meta">
    <ResponseField name="request_id" type="string">
      Unique request identifier for tracing and support
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO 8601 timestamp of when the request was processed
    </ResponseField>

    <ResponseField name="vocab_release" type="string">
      Vocabulary release version used for this request
    </ResponseField>
  </Expandable>
</ResponseField>

## Examples

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.omophub.com/v1/concepts/320128/mappings?target_vocabulary=ICD10CM" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.omophub.com/v1/concepts/320128/mappings?target_vocabulary=ICD10CM', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  });

  const result = await response.json();
  console.log(`Found ${result.data.mappings.length} mappings`);
  ```

  ```python Python theme={null}
  import requests

  params = {"target_vocabulary": "ICD10CM"}
  response = requests.get(
      "https://api.omophub.com/v1/concepts/320128/mappings",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      params=params
  )
  result = response.json()
  print(f"Found {len(result['data']['mappings'])} mappings")
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "mappings": [
        {
          "source_concept_id": 320128,
          "source_concept_name": "Essential hypertension",
          "target_concept_id": 319826,
          "target_concept_name": "Essential hypertension",
          "relationship_id": "Maps to",
          "confidence": 1.0
        }
      ]
    },
    "meta": {
      "request_id": "req_abc123",
      "timestamp": "2025-01-05T12:00:00.000Z",
      "vocab_release": "2025.1"
    }
  }
  ```
</ResponseExample>

## Related Endpoints

* [Map Concepts](/api-reference/mappings/map-concepts) - Map multiple concepts to a target vocabulary
* [Batch Map Concepts](/api-reference/mappings/batch-map-concepts) - Batch mapping operations