Overview
Retrieve all mappings from a concept to equivalent or related concepts in other vocabulary systems.
Path Parameters
The OMOP concept ID to get mappings for
Query Parameters
Filter mappings to a specific target vocabulary (e.g., “ICD10CM”, “SNOMED”)
Include invalid/deprecated mappings in results
Specific vocabulary release version to use (e.g., “2025.1”, “2024.4”).
When not specified, uses the default/latest vocabulary version.
Response
Indicates if the request was successful
Contains the mapping results
Array of concept mappings
OMOP concept ID of the source concept
Name of the source concept
OMOP concept ID of the mapped target concept
Name of the target concept
Type of relationship (e.g., “Maps to”)
Confidence score for the mapping (0.0 to 1.0)
Response metadata
Unique request identifier for tracing and support
ISO 8601 timestamp of when the request was processed
Vocabulary release version used for this request
Examples
curl -X GET "https://api.omophub.com/v1/concepts/320128/mappings?target_vocabulary=ICD10CM" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"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"
}
}
