Skip to main content
curl -X GET "https://api.omophub.com/v1/concepts/320128/mappings?targetVocabulary=ICD10CM" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "success": true,
  "data": {
    "concept": {
      "concept_id": 320128,
      "concept_name": "Essential hypertension",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition"
    },
    "mappings": [
      {
        "target_concept_id": 319826,
        "target_concept_name": "Essential hypertension",
        "target_concept_code": "I10",
        "target_vocabulary_id": "ICD10CM",
        "target_domain_id": "Condition",
        "mapping_type": "Maps to",
        "relationship_id": "Maps to",
        "mapping_confidence": 1.0,
        "is_primary_mapping": true,
        "valid_start_date": "2015-10-01T00:00:00Z",
        "valid_end_date": "2099-12-31T00:00:00Z"
      }
    ],
    "mapping_summary": {
      "total_mappings": 1,
      "target_vocabularies": ["ICD10CM"],
      "mapping_types": ["Maps to"],
      "primary_mappings": 1
    }
  },
  "meta": {
    "request_id": "req_mappings_320128_20241222_103300",
    "timestamp": "2024-12-22T10:33:00Z",
    "vocab_release": "2025.2"
  }
}

Overview

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

Path Parameters

conceptId
integer
required
The concept ID to get mappings for

Query Parameters

targetVocabulary
string
Filter mappings to specific vocabulary
mappingType
string
Filter by mapping type: “Maps to”, “Maps to value”

Examples

curl -X GET "https://api.omophub.com/v1/concepts/320128/mappings?targetVocabulary=ICD10CM" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "success": true,
  "data": {
    "concept": {
      "concept_id": 320128,
      "concept_name": "Essential hypertension",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition"
    },
    "mappings": [
      {
        "target_concept_id": 319826,
        "target_concept_name": "Essential hypertension",
        "target_concept_code": "I10",
        "target_vocabulary_id": "ICD10CM",
        "target_domain_id": "Condition",
        "mapping_type": "Maps to",
        "relationship_id": "Maps to",
        "mapping_confidence": 1.0,
        "is_primary_mapping": true,
        "valid_start_date": "2015-10-01T00:00:00Z",
        "valid_end_date": "2099-12-31T00:00:00Z"
      }
    ],
    "mapping_summary": {
      "total_mappings": 1,
      "target_vocabularies": ["ICD10CM"],
      "mapping_types": ["Maps to"],
      "primary_mappings": 1
    }
  },
  "meta": {
    "request_id": "req_mappings_320128_20241222_103300",
    "timestamp": "2024-12-22T10:33:00Z",
    "vocab_release": "2025.2"
  }
}
I