curl -H "Authorization: Bearer $OMOPHUB_API_KEY" \
"https://api.omophub.com/v1/mappings/quality/ICD10CM/SNOMED?vocab_release=2025.2"
{
"success": true,
"data": {
"source_vocabulary": "ICD10CM",
"target_vocabulary": "SNOMED",
"total_concepts": 98186,
"mapped_concepts": 97707,
"coverage_percentage": 99.51215040840853,
"mapping_types": [
{ "type": "direct", "count": 97305, "percentage": 99.58856581411773 },
{ "type": "other", "count": 402, "percentage": 0.4114341858822807 }
],
"quality_score": 90,
"issues": [
{
"issue_type": "Unmapped concepts",
"count": 479,
"severity": "low",
"examples": []
}
]
},
"meta": {
"request_id": "req_01HXYZ",
"timestamp": "2026-09-11T12:00:00.000Z",
"vocab_release": "2025.2"
}
}
Get Mapping Quality
Measure concept coverage and mapping composition for one directed vocabulary pair.
curl -H "Authorization: Bearer $OMOPHUB_API_KEY" \
"https://api.omophub.com/v1/mappings/quality/ICD10CM/SNOMED?vocab_release=2025.2"
{
"success": true,
"data": {
"source_vocabulary": "ICD10CM",
"target_vocabulary": "SNOMED",
"total_concepts": 98186,
"mapped_concepts": 97707,
"coverage_percentage": 99.51215040840853,
"mapping_types": [
{ "type": "direct", "count": 97305, "percentage": 99.58856581411773 },
{ "type": "other", "count": 402, "percentage": 0.4114341858822807 }
],
"quality_score": 90,
"issues": [
{
"issue_type": "Unmapped concepts",
"count": 479,
"severity": "low",
"examples": []
}
]
},
"meta": {
"request_id": "req_01HXYZ",
"timestamp": "2026-09-11T12:00:00.000Z",
"vocab_release": "2025.2"
}
}
Measure how many valid concepts in a source vocabulary have at least one valid
relationship to a valid concept in a target vocabulary. The pair is directed:
Coverage therefore contributes up to 50 points, the share classified as
SNOMED → ICD10CM and ICD10CM → SNOMED have different source
populations and can produce different results.
Parameters
string
required
Source vocabulary identifier, such as
ICD10CM, SNOMED, or RxNorm.string
required
Target vocabulary identifier, such as
SNOMED, ICD10CM, or ATC.string
Vocabulary release to query, for example
2025.2. The current default release
is used when omitted.How the metrics are calculated
total_conceptsis the number of valid concepts insource_vocabulary.mapped_conceptsis the number of those distinct source concepts with at least one valid relationship to a valid concept intarget_vocabulary.coverage_percentageis100 × mapped_concepts / total_concepts(or0when the source has no valid concepts).- Each mapped source concept contributes exactly once to
mapping_types. If a source has several relationships or target concepts, its best available type wins in this order:direct,equivalent,hierarchical,other. Consequently, the type counts always sum tomapped_concepts; percentages usemapped_conceptsas their denominator and sum to 100 when mappings exist.
quality_score is a heuristic summary, rounded to the nearest
whole number:
50 × coverage_fraction
+ 30 × direct_mapping_fraction
+ 20 × min(number_of_mapping_types / 4, 1)
direct contributes up to 30, and mapping-type diversity contributes up to 20.
Use the underlying metrics—not this heuristic alone—for clinical or ETL
decisions.
Response
boolean
required
Whether quality analysis completed.
object
required
Mapping quality metrics and issues.
object
required
Request and vocabulary-release metadata.
string
required
Correlation identifier for this request.
string
required
ISO 8601 response timestamp.
string
required
Vocabulary release used to calculate the metrics.
string
required
Requested source vocabulary.
string
required
Requested target vocabulary.
integer
required
Valid source concepts; denominator of
coverage_percentage.integer
required
Distinct mapped source concepts; numerator of
coverage_percentage and sum of
all mapping_types[].count values.number
required
Percentage of valid source concepts mapped to the target vocabulary, from 0 to
100.
array
required
integer
required
Rounded 0–100 heuristic composed of coverage (50%), direct mapping share
(30%), and mapping-type diversity (20%).
array
required
curl -H "Authorization: Bearer $OMOPHUB_API_KEY" \
"https://api.omophub.com/v1/mappings/quality/ICD10CM/SNOMED?vocab_release=2025.2"
{
"success": true,
"data": {
"source_vocabulary": "ICD10CM",
"target_vocabulary": "SNOMED",
"total_concepts": 98186,
"mapped_concepts": 97707,
"coverage_percentage": 99.51215040840853,
"mapping_types": [
{ "type": "direct", "count": 97305, "percentage": 99.58856581411773 },
{ "type": "other", "count": 402, "percentage": 0.4114341858822807 }
],
"quality_score": 90,
"issues": [
{
"issue_type": "Unmapped concepts",
"count": 479,
"severity": "low",
"examples": []
}
]
},
"meta": {
"request_id": "req_01HXYZ",
"timestamp": "2026-09-11T12:00:00.000Z",
"vocab_release": "2025.2"
}
}
Counts depend on the selected vocabulary release. The example illustrates the
response shape; query the endpoint for current release-specific values.
Was this page helpful?