Skip to main content
GET
/
v1
/
mappings
/
coverage
curl -X GET "https://api.omophub.com/v1/mappings/coverage?domain_ids=Condition,Drug&include_detailed_gaps=true&include_recommendations=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "coverage_overview": {
      "total_concepts_analyzed": 123,
      "concepts_with_mappings": 123,
      "concepts_without_mappings": 123,
      "overall_coverage_percentage": 123,
      "unique_vocabulary_pairs": 123,
      "total_mapping_relationships": 123
    },
    "vocabulary_coverage": {
      "[vocabulary_id]": {
        "vocabulary_name": "<string>",
        "total_concepts": 123,
        "concepts_with_outgoing_mappings": 123,
        "concepts_with_incoming_mappings": 123,
        "outgoing_coverage_percentage": 123,
        "incoming_coverage_percentage": 123,
        "mapping_targets": [
          {}
        ],
        "mapping_sources": [
          {}
        ],
        "coverage_by_domain": {},
        "coverage_rating": "<string>"
      }
    },
    "domain_coverage": {
      "[domain_id]": {
        "domain_name": "<string>",
        "total_concepts": 123,
        "concepts_with_mappings": 123,
        "coverage_percentage": 123,
        "vocabulary_coverage": {},
        "best_mapped_vocabularies": [
          {}
        ],
        "poorly_mapped_vocabularies": [
          {}
        ],
        "interoperability_score": 123
      }
    },
    "vocabulary_pair_matrix": {
      "matrix_data": {
        "source_vocabulary": "<string>",
        "target_vocabulary": "<string>",
        "mapping_count": 123,
        "source_coverage_percentage": 123,
        "target_coverage_percentage": 123,
        "bidirectional_coverage": true
      },
      "strongest_pairs": [
        {}
      ],
      "weakest_pairs": [
        {}
      ]
    },
    "mapping_gaps": {
      "critical_gaps": [
        {
          "gap_type": "<string>",
          "description": "<string>",
          "affected_concepts": 123,
          "business_impact": "<string>",
          "priority": "<string>"
        }
      ],
      "gap_patterns": [
        {}
      ],
      "unmapped_concept_samples": {},
      "orphaned_vocabularies": [
        {}
      ]
    },
    "quality_analysis": {
      "overall_quality_metrics": {
        "average_confidence_score": 123,
        "high_quality_mappings_percentage": 123,
        "validated_mappings_percentage": 123,
        "disputed_mappings_count": 123
      },
      "quality_by_vocabulary_pair": {},
      "quality_by_domain": {},
      "equivalence_type_distribution": {}
    },
    "trends": {
      "coverage_over_time": [
        {
          "date": "<string>",
          "overall_coverage_percentage": 123,
          "new_mappings_added": 123,
          "mappings_deprecated": 123
        }
      ],
      "improvement_rate": 123,
      "fastest_improving_areas": [
        {}
      ],
      "stagnant_areas": [
        {}
      ]
    },
    "recommendations": [
      {
        "recommendation_type": "<string>",
        "title": "<string>",
        "description": "<string>",
        "priority": "<string>",
        "estimated_impact": "<string>",
        "affected_areas": [
          {}
        ],
        "implementation_complexity": "<string>"
      }
    ],
    "meta": {
      "analysis_date": "<string>",
      "data_freshness": "<string>",
      "analysis_scope": {},
      "calculation_time_ms": 123
    }
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "<string>",
    "vocab_release": "<string>"
  }
}
This endpoint provides comprehensive analysis of mapping coverage across the vocabulary ecosystem, essential for understanding data interoperability capabilities, identifying translation gaps, and planning vocabulary integration strategies.

​
Query Parameters

​
source_vocabularies
string
Filter analysis to specific source vocabularies
Example: SNOMED,ICD10CM,RxNorm
​
target_vocabularies
string
Filter analysis to specific target vocabularies
Example: ICD10CM,HCPCS,NDC
​
domain_ids
string
Focus analysis on specific domains
Example: Condition,Drug,Procedure
​
concept_class_ids
string
Focus analysis on specific concept classes
Example: Clinical Finding,Procedure,Ingredient
​
include_detailed_gaps
boolean
default:"false"
Include detailed analysis of mapping gaps
​
include_quality_analysis
boolean
default:"false"
Include mapping quality distribution analysis
​
include_recommendations
boolean
default:"false"
Include recommendations for improving coverage
​
include_trends
boolean
default:"false"
Include historical trends in mapping coverage
​
coverage_threshold
number
default:"80"
Threshold for considering coverage “good” (0-100 percentage scale)
​
standard_only
boolean
default:"true"
Only analyze standard concepts
​
active_only
boolean
default:"true"
Only analyze active concepts

​
Response

​
success
boolean
required
Indicates if the request was successful
​
data
object
required
Response data containing coverage analysis
​
meta
object
required
Response metadata and API information
curl -X GET "https://api.omophub.com/v1/mappings/coverage?domain_ids=Condition,Drug&include_detailed_gaps=true&include_recommendations=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response Example

{
  "coverage_overview": {
    "total_concepts_analyzed": 2847562,
    "concepts_with_mappings": 1678934,
    "concepts_without_mappings": 1168628,
    "overall_coverage_percentage": 59.0,
    "unique_vocabulary_pairs": 147,
    "total_mapping_relationships": 4578923
  },
  "vocabulary_coverage": {
    "SNOMED": {
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "total_concepts": 387421,
      "concepts_with_outgoing_mappings": 234567,
      "concepts_with_incoming_mappings": 89234,
      "outgoing_coverage_percentage": 60.5,
      "incoming_coverage_percentage": 23.0,
      "mapping_targets": ["ICD10CM", "ICD10", "HCPCS", "ICD9CM"],
      "mapping_sources": ["Read", "ICD9CM", "ICD10"],
      "coverage_by_domain": {
        "Condition": 78.2,
        "Procedure": 45.7,
        "Observation": 23.1
      },
      "coverage_rating": "good"
    },
    "ICD10CM": {
      "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
      "total_concepts": 98234,
      "concepts_with_outgoing_mappings": 87432,
      "concepts_with_incoming_mappings": 87432,
      "outgoing_coverage_percentage": 89.0,
      "incoming_coverage_percentage": 89.0,
      "mapping_targets": ["SNOMED", "ICD10"],
      "mapping_sources": ["SNOMED", "ICD9CM"],
      "coverage_by_domain": {
        "Condition": 92.1,
        "Procedure": 85.4
      },
      "coverage_rating": "excellent"
    }
  },
  "domain_coverage": {
    "Condition": {
      "domain_name": "Condition",
      "total_concepts": 845672,
      "concepts_with_mappings": 623891,
      "coverage_percentage": 73.8,
      "vocabulary_coverage": {
        "SNOMED": 78.2,
        "ICD10CM": 92.1,
        "ICD10": 87.5,
        "ICD9CM": 45.3
      },
      "best_mapped_vocabularies": ["ICD10CM", "ICD10", "SNOMED"],
      "poorly_mapped_vocabularies": ["Read", "ICPC2"],
      "interoperability_score": 0.82
    },
    "Drug": {
      "domain_name": "Drug",
      "total_concepts": 652341,
      "concepts_with_mappings": 298765,
      "coverage_percentage": 45.8,
      "vocabulary_coverage": {
        "RxNorm": 67.3,
        "NDC": 89.2,
        "SNOMED": 23.4
      },
      "best_mapped_vocabularies": ["NDC", "RxNorm"],
      "poorly_mapped_vocabularies": ["SNOMED", "ATC"],
      "interoperability_score": 0.61
    }
  },
  "vocabulary_pair_matrix": {
    "strongest_pairs": [
      {
        "source_vocabulary": "ICD10CM",
        "target_vocabulary": "SNOMED",
        "source_coverage_percentage": 89.0,
        "target_coverage_percentage": 67.2,
        "bidirectional_coverage": true
      },
      {
        "source_vocabulary": "RxNorm",
        "target_vocabulary": "NDC",
        "source_coverage_percentage": 78.5,
        "target_coverage_percentage": 89.2,
        "bidirectional_coverage": true
      }
    ],
    "weakest_pairs": [
      {
        "source_vocabulary": "LOINC",
        "target_vocabulary": "HCPCS",
        "source_coverage_percentage": 12.3,
        "target_coverage_percentage": 8.7,
        "bidirectional_coverage": false
      }
    ],
    "matrix_data": {
      "ICD10CM_SNOMED": {
        "source_vocabulary": "ICD10CM",
        "target_vocabulary": "SNOMED", 
        "mapping_count": 8934,
        "source_coverage_percentage": 89.0,
        "target_coverage_percentage": 67.2,
        "bidirectional_coverage": true
      },
      "RxNorm_NDC": {
        "source_vocabulary": "RxNorm",
        "target_vocabulary": "NDC",
        "mapping_count": 12456,
        "source_coverage_percentage": 78.5,
        "target_coverage_percentage": 89.2,
        "bidirectional_coverage": true
      },
      "LOINC_HCPCS": {
        "source_vocabulary": "LOINC",
        "target_vocabulary": "HCPCS",
        "mapping_count": 234,
        "source_coverage_percentage": 12.3,
        "target_coverage_percentage": 8.7,
        "bidirectional_coverage": false
      }
    }
  },
  "mapping_gaps": {
    "critical_gaps": [
      {
        "gap_type": "Domain Coverage Gap",
        "description": "Observation domain concepts have limited cross-vocabulary mappings",
        "affected_concepts": 234567,
        "business_impact": "Reduced interoperability for lab results and vital signs",
        "priority": "high"
      },
      {
        "gap_type": "Vocabulary Isolation",
        "description": "LOINC concepts have minimal mappings to billing vocabularies",
        "affected_concepts": 89234,
        "business_impact": "Difficulty translating lab orders to billing codes",
        "priority": "medium"
      }
    ],
    "gap_patterns": [
      "Specialized medical devices lack standard mappings",
      "Research-focused concepts often unmapped to clinical vocabularies",
      "Regional vocabulary variations create mapping inconsistencies"
    ],
    "orphaned_vocabularies": ["ICPC2", "Read", "Local vocabularies"]
  },
  "quality_analysis": {
    "overall_quality_metrics": {
      "average_confidence_score": 0.847,
      "high_quality_mappings_percentage": 72.3,
      "validated_mappings_percentage": 68.9,
      "disputed_mappings_count": 12456
    },
    "quality_by_domain": {
      "Condition": {
        "average_confidence": 0.891,
        "validation_rate": 78.2
      },
      "Drug": {
        "average_confidence": 0.823,
        "validation_rate": 65.7
      }
    }
  },
  "trends": {
    "coverage_over_time": [
      {
        "date": "2020-01-01T00:00:00Z",
        "overall_coverage_percentage": 52.3,
        "new_mappings_added": 45678,
        "mappings_deprecated": 3456
      },
      {
        "date": "2021-01-01T00:00:00Z",
        "overall_coverage_percentage": 55.1,
        "new_mappings_added": 67890,
        "mappings_deprecated": 4567
      },
      {
        "date": "2024-01-01T00:00:00Z",
        "overall_coverage_percentage": 59.0,
        "new_mappings_added": 123456,
        "mappings_deprecated": 7890
      }
    ],
    "improvement_rate": 2.1,
    "fastest_improving_areas": [
      "Drug domain RxNorm mappings",
      "ICD10CM to SNOMED bidirectional coverage",
      "Procedure domain standardization"
    ]
  },
  "recommendations": [
    {
      "recommendation_type": "vocabulary_expansion",
      "title": "Expand LOINC to HCPCS mappings for lab procedures",
      "description": "Create systematic mappings between LOINC lab concepts and corresponding HCPCS billing codes to improve lab order interoperability",
      "priority": "high",
      "estimated_impact": "Improve lab domain coverage by 15-20%",
      "affected_areas": ["LOINC", "HCPCS", "Measurement domain"],
      "implementation_complexity": "moderate"
    },
    {
      "recommendation_type": "quality_improvement",
      "title": "Review and validate disputed mappings",
      "description": "Systematic review of 12,456 disputed mappings to improve overall mapping quality",
      "priority": "medium",
      "estimated_impact": "Increase validated mapping percentage to 75%+",
      "affected_areas": ["All vocabularies"],
      "implementation_complexity": "high"
    }
  ],
  "meta": {
    "analysis_date": "2024-12-22T10:00:00Z",
    "data_freshness": "2024-12-22T08:30:00Z",
    "analysis_scope": {
      "vocabularies_included": 23,
      "domains_analyzed": 15,
      "concept_classes_analyzed": 156
    },
    "calculation_time_ms": 15247.8
  }
}

​
Usage Examples

​
Overall Coverage Analysis

Get comprehensive mapping coverage overview: 
const coverage = await fetch('/v1/mappings/coverage');

​
Domain-Specific Coverage

Analyze coverage for specific medical domains: 
const clinicalCoverage = await fetch('/v1/mappings/coverage?domain_ids=Condition,Drug,Procedure&include_detailed_gaps=true');

​
Quality-Focused Analysis

Get coverage analysis with quality metrics: 
const qualityCoverage = await fetch('/v1/mappings/coverage?include_quality_analysis=true&coverage_threshold=80');

​
Vocabulary-Specific Coverage

Analyze coverage for specific vocabularies: 
const snomedCoverage = await fetch('/v1/mappings/coverage?source_vocabularies=SNOMED&target_vocabularies=ICD10CM,HCPCS&include_recommendations=true');

​
Trend Analysis

Get historical coverage trends: 
const trendAnalysis = await fetch('/v1/mappings/coverage?include_trends=true&include_recommendations=true');

​
Notes

  • Coverage analysis is computationally intensive and may take longer for comprehensive queries
  • Quality analysis requires mapping metadata and may not be available for all vocabulary pairs
  • Trends analysis requires historical data spanning multiple vocabulary releases
  • Recommendations are generated based on gap analysis and usage patterns
  • Coverage thresholds help identify vocabularies needing mapping improvements
  • Orphaned vocabularies may require custom mapping strategies
  • Domain coverage varies significantly based on vocabulary specialization
  • Regular coverage monitoring helps identify degradation over time