Skip to main content
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": "direct",
    "include_invalid": false
  }'

{
  "success": true,
  "data": {
    "mappings": [
      {
        "source_concept_id": 201826,
        "source_concept_name": "Type 2 diabetes mellitus",
        "source_concept_code": "44054006",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208413,
        "target_concept_name": "Type 2 diabetes mellitus",
        "target_concept_code": "E11.9",
        "target_vocabulary_id": "ICD10CM",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "mapping_confidence": 1.0,
        "mapping_type": "direct"
      },
      {
        "source_concept_id": 192671,
        "source_concept_name": "Myocardial infarction",
        "source_concept_code": "22298006",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208604,
        "target_concept_name": "Acute myocardial infarction, unspecified",
        "target_concept_code": "I21.9",
        "target_vocabulary_id": "ICD10CM",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "mapping_confidence": 1.0,
        "mapping_type": "direct"
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-01-05T12:00:00.000Z",
    "vocab_release": "2025.1"
  }
}

​
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

​
Query Parameters

​
vocab_release
string
Specific vocabulary release version to use for mapping (e.g., “2025.1”, “2024.2”). When not specified, uses the default/latest vocabulary version.

​
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
​
meta
object
Response metadata
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": "direct",
    "include_invalid": false
  }'

{
  "success": true,
  "data": {
    "mappings": [
      {
        "source_concept_id": 201826,
        "source_concept_name": "Type 2 diabetes mellitus",
        "source_concept_code": "44054006",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208413,
        "target_concept_name": "Type 2 diabetes mellitus",
        "target_concept_code": "E11.9",
        "target_vocabulary_id": "ICD10CM",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "mapping_confidence": 1.0,
        "mapping_type": "direct"
      },
      {
        "source_concept_id": 192671,
        "source_concept_name": "Myocardial infarction",
        "source_concept_code": "22298006",
        "source_vocabulary_id": "SNOMED",
        "target_concept_id": 35208604,
        "target_concept_name": "Acute myocardial infarction, unspecified",
        "target_concept_code": "I21.9",
        "target_vocabulary_id": "ICD10CM",
        "relationship_id": "Maps to",
        "relationship_name": "Maps to",
        "valid_start_date": "2023-01-01",
        "valid_end_date": "2099-12-31",
        "invalid_reason": null,
        "mapping_confidence": 1.0,
        "mapping_type": "direct"
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2025-01-05T12:00:00.000Z",
    "vocab_release": "2025.1"
  }
}

​
Usage Examples

​
Basic Concept Mapping

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

​
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 using OMOP concept IDs: 
{
  "source_concepts": [4306040, 4032577],
  "target_vocabulary": "RxNorm",
  "mapping_type": "equivalent"
}
Or using vocabulary codes directly (recommended when you have source system codes): 
{
  "source_codes": [
    {"vocabulary_id": "SNOMED", "concept_code": "387517004"},
    {"vocabulary_id": "SNOMED", "concept_code": "108774000"}
  ],
  "target_vocabulary": "RxNorm",
  "mapping_type": "equivalent"
}
The source_concepts parameter expects OMOP concept IDs, not vocabulary-specific codes like SNOMED codes. If you have vocabulary codes (e.g., SNOMED code “387517004”), use the source_codes parameter instead, or first look up the OMOP concept ID using /v1/concepts/by-code/{vocabulary}/{code}.