curl -X GET "https://api.omophub.com/v1/mappings/quality/SNOMED/ICD10CM" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"quality_overview": {
"total_mappings_analyzed": 4578923,
"mappings_with_quality_data": 3456789,
"overall_average_confidence": 0.847,
"overall_quality_rating": "good",
"high_quality_percentage": 72.3,
"validated_percentage": 68.9,
"disputed_percentage": 2.7
},
"quality_by_vocabulary_pair": {
"SNOMED": {
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"target_vocabularies": {
"ICD10CM": {
"target_vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"total_mappings": 156789,
"average_confidence": 0.923,
"median_confidence": 0.950,
"confidence_std_dev": 0.087,
"equivalence_distribution": {
"exact": 89234,
"broader": 45678,
"narrower": 12345,
"related": 9532
},
"validation_rate": 0.847,
"quality_rating": "excellent",
"primary_use_cases": ["billing", "quality_reporting", "clinical_documentation"]
},
"HCPCS": {
"target_vocabulary_name": "Healthcare Common Procedure Coding System",
"total_mappings": 67890,
"average_confidence": 0.756,
"median_confidence": 0.780,
"confidence_std_dev": 0.145,
"equivalence_distribution": {
"exact": 23456,
"broader": 34567,
"narrower": 6789,
"related": 3078
},
"validation_rate": 0.623,
"quality_rating": "good",
"primary_use_cases": ["billing", "procedure_coding"]
}
},
"overall_outgoing_quality": 0.875
}
},
"quality_by_domain": {
"Condition": {
"domain_name": "Condition",
"total_mappings": 2847562,
"average_confidence": 0.891,
"quality_distribution": {
"excellent": 1456789,
"good": 987654,
"moderate": 345678,
"poor": 57441
},
"most_reliable_vocabulary_pairs": [
"SNOMED → ICD10CM",
"ICD10CM → SNOMED",
"SNOMED → ICD10"
],
"least_reliable_vocabulary_pairs": [
"Read → ICPC2",
"Local → Standard"
],
"quality_challenges": [
"Complex conditions often map to broader categories",
"Regional terminology variations affect consistency",
"Rare diseases have limited mapping coverage"
]
},
"Drug": {
"domain_name": "Drug",
"total_mappings": 987654,
"average_confidence": 0.823,
"quality_distribution": {
"excellent": 456789,
"good": 345678,
"moderate": 123456,
"poor": 61731
},
"most_reliable_vocabulary_pairs": [
"RxNorm → NDC",
"NDC → RxNorm"
],
"least_reliable_vocabulary_pairs": [
"SNOMED → RxNorm",
"Local drug codes → RxNorm"
],
"quality_challenges": [
"Generic vs brand name mapping complexity",
"Dosage form variations affect precision",
"Discontinued medications create gaps"
]
}
},
"quality_metrics": {
"confidence_score_distribution": {
"histogram_bins": [
{"min": 0.0, "max": 0.1, "count": 12456},
{"min": 0.1, "max": 0.2, "count": 23456},
{"min": 0.8, "max": 0.9, "count": 456789},
{"min": 0.9, "max": 1.0, "count": 678901}
],
"percentiles": {
"25": 0.734,
"50": 0.847,
"75": 0.923,
"95": 0.978
},
"skewness": -0.342,
"kurtosis": 2.156
},
"semantic_similarity_analysis": {
"average_similarity": 0.823,
"similarity_confidence_correlation": 0.756,
"low_similarity_high_confidence": 23456,
"high_similarity_low_confidence": 12345
},
"mapping_source_analysis": {
"official_mappings": {
"average_confidence": 0.912,
"total_count": 2345678,
"validation_rate": 0.923
},
"community_mappings": {
"average_confidence": 0.734,
"total_count": 456789,
"validation_rate": 0.456
},
"algorithmic_mappings": {
"average_confidence": 0.678,
"total_count": 567890,
"validation_rate": 0.234
}
}
},
"quality_outliers": {
"low_quality_outliers": [
{
"source_concept_id": 12345,
"target_concept_id": 67890,
"confidence_score": 0.123,
"outlier_reason": "Very low confidence despite official mapping",
"potential_issues": [
"Semantic mismatch",
"Outdated mapping relationship"
]
}
],
"outlier_patterns": [
"Algorithmic mappings between distant concept classes",
"Legacy mappings not updated with vocabulary revisions",
"Cross-domain mappings with semantic drift"
]
},
"recommendations": [
{
"recommendation_type": "validation_review",
"title": "Review disputed SNOMED to HCPCS mappings",
"description": "Systematic review of 2,847 disputed mappings between SNOMED procedures and HCPCS codes to improve validation rate",
"priority": "high",
"expected_improvement": "Increase HCPCS mapping quality by 15-20%",
"affected_vocabulary_pairs": ["SNOMED → HCPCS"],
"implementation_effort": "moderate"
},
{
"recommendation_type": "algorithmic_improvement",
"title": "Enhance semantic similarity algorithms for drug mappings",
"description": "Improve algorithmic mapping quality between drug vocabularies using enhanced semantic similarity models",
"priority": "medium",
"expected_improvement": "Increase drug domain confidence by 10%",
"affected_vocabulary_pairs": ["RxNorm → NDC", "SNOMED → RxNorm"],
"implementation_effort": "high"
}
]
},
"meta": {
"request_id": "req_quality_analysis_234567",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2",
"analysis_scope": {
"vocabularies_included": 23,
"domains_analyzed": 15,
"mapping_relationships_analyzed": 4578923
},
"confidence_calculation_method": "weighted_semantic_similarity_with_validation"
}
}
Get Mapping Quality
Analyze OMOP mapping quality between two vocabularies to assess reliability and trustworthiness of cross-vocabulary translations for production use.
curl -X GET "https://api.omophub.com/v1/mappings/quality/SNOMED/ICD10CM" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"quality_overview": {
"total_mappings_analyzed": 4578923,
"mappings_with_quality_data": 3456789,
"overall_average_confidence": 0.847,
"overall_quality_rating": "good",
"high_quality_percentage": 72.3,
"validated_percentage": 68.9,
"disputed_percentage": 2.7
},
"quality_by_vocabulary_pair": {
"SNOMED": {
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"target_vocabularies": {
"ICD10CM": {
"target_vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"total_mappings": 156789,
"average_confidence": 0.923,
"median_confidence": 0.950,
"confidence_std_dev": 0.087,
"equivalence_distribution": {
"exact": 89234,
"broader": 45678,
"narrower": 12345,
"related": 9532
},
"validation_rate": 0.847,
"quality_rating": "excellent",
"primary_use_cases": ["billing", "quality_reporting", "clinical_documentation"]
},
"HCPCS": {
"target_vocabulary_name": "Healthcare Common Procedure Coding System",
"total_mappings": 67890,
"average_confidence": 0.756,
"median_confidence": 0.780,
"confidence_std_dev": 0.145,
"equivalence_distribution": {
"exact": 23456,
"broader": 34567,
"narrower": 6789,
"related": 3078
},
"validation_rate": 0.623,
"quality_rating": "good",
"primary_use_cases": ["billing", "procedure_coding"]
}
},
"overall_outgoing_quality": 0.875
}
},
"quality_by_domain": {
"Condition": {
"domain_name": "Condition",
"total_mappings": 2847562,
"average_confidence": 0.891,
"quality_distribution": {
"excellent": 1456789,
"good": 987654,
"moderate": 345678,
"poor": 57441
},
"most_reliable_vocabulary_pairs": [
"SNOMED → ICD10CM",
"ICD10CM → SNOMED",
"SNOMED → ICD10"
],
"least_reliable_vocabulary_pairs": [
"Read → ICPC2",
"Local → Standard"
],
"quality_challenges": [
"Complex conditions often map to broader categories",
"Regional terminology variations affect consistency",
"Rare diseases have limited mapping coverage"
]
},
"Drug": {
"domain_name": "Drug",
"total_mappings": 987654,
"average_confidence": 0.823,
"quality_distribution": {
"excellent": 456789,
"good": 345678,
"moderate": 123456,
"poor": 61731
},
"most_reliable_vocabulary_pairs": [
"RxNorm → NDC",
"NDC → RxNorm"
],
"least_reliable_vocabulary_pairs": [
"SNOMED → RxNorm",
"Local drug codes → RxNorm"
],
"quality_challenges": [
"Generic vs brand name mapping complexity",
"Dosage form variations affect precision",
"Discontinued medications create gaps"
]
}
},
"quality_metrics": {
"confidence_score_distribution": {
"histogram_bins": [
{"min": 0.0, "max": 0.1, "count": 12456},
{"min": 0.1, "max": 0.2, "count": 23456},
{"min": 0.8, "max": 0.9, "count": 456789},
{"min": 0.9, "max": 1.0, "count": 678901}
],
"percentiles": {
"25": 0.734,
"50": 0.847,
"75": 0.923,
"95": 0.978
},
"skewness": -0.342,
"kurtosis": 2.156
},
"semantic_similarity_analysis": {
"average_similarity": 0.823,
"similarity_confidence_correlation": 0.756,
"low_similarity_high_confidence": 23456,
"high_similarity_low_confidence": 12345
},
"mapping_source_analysis": {
"official_mappings": {
"average_confidence": 0.912,
"total_count": 2345678,
"validation_rate": 0.923
},
"community_mappings": {
"average_confidence": 0.734,
"total_count": 456789,
"validation_rate": 0.456
},
"algorithmic_mappings": {
"average_confidence": 0.678,
"total_count": 567890,
"validation_rate": 0.234
}
}
},
"quality_outliers": {
"low_quality_outliers": [
{
"source_concept_id": 12345,
"target_concept_id": 67890,
"confidence_score": 0.123,
"outlier_reason": "Very low confidence despite official mapping",
"potential_issues": [
"Semantic mismatch",
"Outdated mapping relationship"
]
}
],
"outlier_patterns": [
"Algorithmic mappings between distant concept classes",
"Legacy mappings not updated with vocabulary revisions",
"Cross-domain mappings with semantic drift"
]
},
"recommendations": [
{
"recommendation_type": "validation_review",
"title": "Review disputed SNOMED to HCPCS mappings",
"description": "Systematic review of 2,847 disputed mappings between SNOMED procedures and HCPCS codes to improve validation rate",
"priority": "high",
"expected_improvement": "Increase HCPCS mapping quality by 15-20%",
"affected_vocabulary_pairs": ["SNOMED → HCPCS"],
"implementation_effort": "moderate"
},
{
"recommendation_type": "algorithmic_improvement",
"title": "Enhance semantic similarity algorithms for drug mappings",
"description": "Improve algorithmic mapping quality between drug vocabularies using enhanced semantic similarity models",
"priority": "medium",
"expected_improvement": "Increase drug domain confidence by 10%",
"affected_vocabulary_pairs": ["RxNorm → NDC", "SNOMED → RxNorm"],
"implementation_effort": "high"
}
]
},
"meta": {
"request_id": "req_quality_analysis_234567",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2",
"analysis_scope": {
"vocabularies_included": 23,
"domains_analyzed": 15,
"mapping_relationships_analyzed": 4578923
},
"confidence_calculation_method": "weighted_semantic_similarity_with_validation"
}
}
This endpoint provides analysis of mapping quality between a specific vocabulary pair, essential for understanding the reliability of cross-vocabulary translations, identifying high-confidence mappings, and assessing the trustworthiness of mapping relationships for clinical and operational use.
Path Parameters
The source vocabulary identifier
Example:
Example:
SNOMED, ICD10CM, RxNormThe target vocabulary identifier
Example:
Example:
ICD10CM, HCPCS, NDCQuery Parameters
Specific vocabulary release version to query
Example:
Example:
2025.1Response
High-level summary of mapping quality
Show Quality Overview Object
Show Quality Overview Object
Total number of mappings included in analysis
Mappings that have quality metadata
Overall average confidence score across all mappings
Overall quality assessment
Values:
Values:
excellent, good, moderate, poorPercentage of mappings with confidence > 0.8 (0-100%)
Percentage of officially validated mappings (0-100%)
Percentage of disputed or problematic mappings
Quality metrics for each vocabulary pair
Show Vocabulary Pair Quality Object
Show Vocabulary Pair Quality Object
Quality metrics for each source vocabulary
Show Source Vocabulary Quality Object
Show Source Vocabulary Quality Object
Human-readable vocabulary name
Quality metrics by target vocabulary
Show Target Vocabulary Quality Object
Show Target Vocabulary Quality Object
Quality metrics for this vocabulary pair
Show Pair Quality Metrics Object
Show Pair Quality Metrics Object
Target vocabulary name
Number of mappings between these vocabularies
Average confidence score for this pair
Median confidence score
Standard deviation of confidence scores
Distribution of equivalence types
Rate of validated mappings (0.0-1.0 fraction)
Quality rating for this vocabulary pair
Main use cases for these mappings
Average quality of outgoing mappings
Quality analysis by medical domain
Show Domain Quality Object
Show Domain Quality Object
Quality metrics for each domain
Show Individual Domain Quality Object
Show Individual Domain Quality Object
Human-readable domain name
Number of mappings in this domain
Average confidence score for domain
Distribution of quality levels
Vocabulary pairs with highest quality in this domain
Vocabulary pairs with lowest quality in this domain
Common quality issues in this domain
Detailed quality metrics and distributions
Show Quality Metrics Object
Show Quality Metrics Object
Analysis of semantic similarity scores
Show Semantic Similarity Analysis Object
Show Semantic Similarity Analysis Object
Average semantic similarity score
Correlation between similarity and confidence
Mappings with low similarity but high confidence
Mappings with high similarity but low confidence
Quality breakdown by mapping source
Analysis of quality outliers and anomalies (when include_outliers=true)
Show Quality Outliers Object
Show Quality Outliers Object
Mappings with unusually low quality scores
Mappings with exceptionally high quality
Mappings with inconsistent quality indicators
Common patterns in outlier mappings
Historical quality trends (when include_trends=true)
Show Quality Trends Object
Show Quality Trends Object
Annual rate of quality improvement (0.0-1.0 fraction)
Areas with most rapid quality improvement
Areas with declining quality
Recommendations for quality improvement (when include_recommendations=true)
Show Quality Recommendation Object
Show Quality Recommendation Object
Type of quality improvement recommendation
Brief title of the recommendation
Detailed description
Implementation priority
Expected quality improvement
Vocabulary pairs that would benefit
Estimated implementation effort
Analysis metadata and processing information
Show Metadata Object
Show Metadata Object
Date when quality analysis was performed
Timestamp of underlying mapping data
Scope of the quality analysis
Time taken to perform analysis
Method used to calculate confidence scores
curl -X GET "https://api.omophub.com/v1/mappings/quality/SNOMED/ICD10CM" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"success": true,
"data": {
"quality_overview": {
"total_mappings_analyzed": 4578923,
"mappings_with_quality_data": 3456789,
"overall_average_confidence": 0.847,
"overall_quality_rating": "good",
"high_quality_percentage": 72.3,
"validated_percentage": 68.9,
"disputed_percentage": 2.7
},
"quality_by_vocabulary_pair": {
"SNOMED": {
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"target_vocabularies": {
"ICD10CM": {
"target_vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
"total_mappings": 156789,
"average_confidence": 0.923,
"median_confidence": 0.950,
"confidence_std_dev": 0.087,
"equivalence_distribution": {
"exact": 89234,
"broader": 45678,
"narrower": 12345,
"related": 9532
},
"validation_rate": 0.847,
"quality_rating": "excellent",
"primary_use_cases": ["billing", "quality_reporting", "clinical_documentation"]
},
"HCPCS": {
"target_vocabulary_name": "Healthcare Common Procedure Coding System",
"total_mappings": 67890,
"average_confidence": 0.756,
"median_confidence": 0.780,
"confidence_std_dev": 0.145,
"equivalence_distribution": {
"exact": 23456,
"broader": 34567,
"narrower": 6789,
"related": 3078
},
"validation_rate": 0.623,
"quality_rating": "good",
"primary_use_cases": ["billing", "procedure_coding"]
}
},
"overall_outgoing_quality": 0.875
}
},
"quality_by_domain": {
"Condition": {
"domain_name": "Condition",
"total_mappings": 2847562,
"average_confidence": 0.891,
"quality_distribution": {
"excellent": 1456789,
"good": 987654,
"moderate": 345678,
"poor": 57441
},
"most_reliable_vocabulary_pairs": [
"SNOMED → ICD10CM",
"ICD10CM → SNOMED",
"SNOMED → ICD10"
],
"least_reliable_vocabulary_pairs": [
"Read → ICPC2",
"Local → Standard"
],
"quality_challenges": [
"Complex conditions often map to broader categories",
"Regional terminology variations affect consistency",
"Rare diseases have limited mapping coverage"
]
},
"Drug": {
"domain_name": "Drug",
"total_mappings": 987654,
"average_confidence": 0.823,
"quality_distribution": {
"excellent": 456789,
"good": 345678,
"moderate": 123456,
"poor": 61731
},
"most_reliable_vocabulary_pairs": [
"RxNorm → NDC",
"NDC → RxNorm"
],
"least_reliable_vocabulary_pairs": [
"SNOMED → RxNorm",
"Local drug codes → RxNorm"
],
"quality_challenges": [
"Generic vs brand name mapping complexity",
"Dosage form variations affect precision",
"Discontinued medications create gaps"
]
}
},
"quality_metrics": {
"confidence_score_distribution": {
"histogram_bins": [
{"min": 0.0, "max": 0.1, "count": 12456},
{"min": 0.1, "max": 0.2, "count": 23456},
{"min": 0.8, "max": 0.9, "count": 456789},
{"min": 0.9, "max": 1.0, "count": 678901}
],
"percentiles": {
"25": 0.734,
"50": 0.847,
"75": 0.923,
"95": 0.978
},
"skewness": -0.342,
"kurtosis": 2.156
},
"semantic_similarity_analysis": {
"average_similarity": 0.823,
"similarity_confidence_correlation": 0.756,
"low_similarity_high_confidence": 23456,
"high_similarity_low_confidence": 12345
},
"mapping_source_analysis": {
"official_mappings": {
"average_confidence": 0.912,
"total_count": 2345678,
"validation_rate": 0.923
},
"community_mappings": {
"average_confidence": 0.734,
"total_count": 456789,
"validation_rate": 0.456
},
"algorithmic_mappings": {
"average_confidence": 0.678,
"total_count": 567890,
"validation_rate": 0.234
}
}
},
"quality_outliers": {
"low_quality_outliers": [
{
"source_concept_id": 12345,
"target_concept_id": 67890,
"confidence_score": 0.123,
"outlier_reason": "Very low confidence despite official mapping",
"potential_issues": [
"Semantic mismatch",
"Outdated mapping relationship"
]
}
],
"outlier_patterns": [
"Algorithmic mappings between distant concept classes",
"Legacy mappings not updated with vocabulary revisions",
"Cross-domain mappings with semantic drift"
]
},
"recommendations": [
{
"recommendation_type": "validation_review",
"title": "Review disputed SNOMED to HCPCS mappings",
"description": "Systematic review of 2,847 disputed mappings between SNOMED procedures and HCPCS codes to improve validation rate",
"priority": "high",
"expected_improvement": "Increase HCPCS mapping quality by 15-20%",
"affected_vocabulary_pairs": ["SNOMED → HCPCS"],
"implementation_effort": "moderate"
},
{
"recommendation_type": "algorithmic_improvement",
"title": "Enhance semantic similarity algorithms for drug mappings",
"description": "Improve algorithmic mapping quality between drug vocabularies using enhanced semantic similarity models",
"priority": "medium",
"expected_improvement": "Increase drug domain confidence by 10%",
"affected_vocabulary_pairs": ["RxNorm → NDC", "SNOMED → RxNorm"],
"implementation_effort": "high"
}
]
},
"meta": {
"request_id": "req_quality_analysis_234567",
"timestamp": "2024-12-22T10:00:00Z",
"vocab_release": "2025.2",
"analysis_scope": {
"vocabularies_included": 23,
"domains_analyzed": 15,
"mapping_relationships_analyzed": 4578923
},
"confidence_calculation_method": "weighted_semantic_similarity_with_validation"
}
}
Usage Examples
SNOMED to ICD10CM Quality
Analyze mapping quality between SNOMED and ICD10CM:TypeScript
const { data: quality } = await client.get('/mappings/quality/SNOMED/ICD10CM');
RxNorm to NDC Quality
Analyze drug vocabulary mapping quality:TypeScript
const { data: drugQuality } = await client.get('/mappings/quality/RxNorm/NDC');
With Specific Vocabulary Release
Query quality metrics for a specific vocabulary version:TypeScript
const { data: versionedQuality } = await client.get('/mappings/quality/SNOMED/HCPCS', {
query: { vocab_release: '2025.1' },
});
Related Endpoints
- Get Concept Mappings - Individual concept mapping quality
- Get Vocabulary Mappings - Quality within vocabulary pairs
- Get Mapping Coverage - Coverage vs quality analysis
Notes
- Quality analysis requires substantial computational resources for large datasets
- Confidence scores are calculated using multiple factors including semantic similarity and validation status
- Official mappings generally have higher quality than algorithmic or community mappings
- Quality can vary significantly between vocabulary pairs and domains
- Disputed mappings may indicate areas needing expert review
- Quality trends help identify improvement or degradation over time
- Outlier analysis reveals mappings that may need special attention
- Quality thresholds help focus on the most reliable mappings for production use
Was this page helpful?
⌘I