Skip to main content
POST
https://api.omophub.com
/
v1
/
concepts
/
map
curl -X POST "https://api.omophub.com/v1/concepts/map" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_concepts": [201826, 192671],
    "target_vocabulary": "ICD10CM",
    "mapping_type": "equivalent",
    "include_invalid": false
  }'

{
  "success": true,
  "data": {
    "mappings": [
      {
        "source_concept_id": 201826,
        "source_concept_name": "Type 2 diabetes mellitus",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208413,
        "target_concept_name": "Type 2 diabetes mellitus",
        "target_vocabulary_id": "ICD10CM",
        "target_concept_code": "E11.9",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "mapping_confidence": 0.95,
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31"
      },
      {
        "source_concept_id": 192671,
        "source_concept_name": "Myocardial infarction",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208604,
        "target_concept_name": "Acute myocardial infarction, unspecified",
        "target_vocabulary_id": "ICD10CM",
        "target_concept_code": "I21.9",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "mapping_confidence": 0.92,
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31"
      }
    ],
    "mapping_summary": {
      "total_source_concepts": 2,
      "successful_mappings": 2,
      "failed_mappings": 0,
      "target_vocabulary": "ICD10CM",
      "mapping_type": "equivalent"
    }
  }
  ...
}

​
Overview

This endpoint maps medical concepts from source vocabularies to target vocabularies, finding equivalent or related concepts across different medical terminology systems. It’s essential for healthcare data integration, cross-system interoperability, and clinical data standardization.

​
Request Body

​
Response

​
success
boolean
Indicates if the request was successful
​
error
object
Error information (present only on error responses)
​
data
object
Contains the concept mapping results
curl -X POST "https://api.omophub.com/v1/concepts/map" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_concepts": [201826, 192671],
    "target_vocabulary": "ICD10CM",
    "mapping_type": "equivalent",
    "include_invalid": false
  }'

{
  "success": true,
  "data": {
    "mappings": [
      {
        "source_concept_id": 201826,
        "source_concept_name": "Type 2 diabetes mellitus",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208413,
        "target_concept_name": "Type 2 diabetes mellitus",
        "target_vocabulary_id": "ICD10CM",
        "target_concept_code": "E11.9",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "mapping_confidence": 0.95,
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31"
      },
      {
        "source_concept_id": 192671,
        "source_concept_name": "Myocardial infarction",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208604,
        "target_concept_name": "Acute myocardial infarction, unspecified",
        "target_vocabulary_id": "ICD10CM",
        "target_concept_code": "I21.9",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "mapping_confidence": 0.92,
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31"
      }
    ],
    "mapping_summary": {
      "total_source_concepts": 2,
      "successful_mappings": 2,
      "failed_mappings": 0,
      "target_vocabulary": "ICD10CM",
      "mapping_type": "equivalent"
    }
  }
  ...
}

​
Usage Examples

​
Basic Concept Mapping

Map SNOMED concepts to ICD-10-CM: 
{
  "source_concepts": [201826],
  "target_vocabulary": "ICD10CM",
  "mapping_type": "equivalent"
}

​
Cross-System Integration

Map multiple concepts for EHR integration: 
{
  "source_concepts": [201826, 192671, 443729],
  "target_vocabulary": "ICD10CM",
  "mapping_type": "direct",
  "include_invalid": false
}

​
Drug Mapping

Map drug concepts from SNOMED to RxNorm: 
{
  "source_concepts": [387517004, 108774000],
  "target_vocabulary": "RXNORM", 
  "mapping_type": "equivalent"
}