curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/coverage?analysis_type=comprehensive&target_domains=Condition,Procedure&include_mapping_analysis=true&include_gap_recommendations=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

{
  "success": true,
  "data": {
    "vocabulary_id": "SNOMED",
    "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
    "vocabulary_version": "2024.2",
    "analysis_date": "2024-03-15T10:30:00Z",
    "overall_coverage": {
      "coverage_score": 87.5,
      "completeness_rating": "Excellent",
      "total_concepts": 354652,
      "domains_covered": 18,
      "specialty_coverage_percentage": 89.2
    },
    "domain_coverage": [
      {
        "domain_id": "Condition",
        "domain_name": "Condition",
        "concept_count": 125643,
        "coverage_score": 95.2,
        "coverage_level": "Excellent",
        "concept_class_distribution": [
          {
            "concept_class_id": "Clinical Finding",
            "concept_count": 89567,
            "coverage_percentage": 71.3
          },
          {
            "concept_class_id": "Disorder",
            "concept_count": 36076,
            "coverage_percentage": 28.7
          }
        ],
        "specialty_relevance": [
          "cardiology",
          "oncology",
          "endocrinology",
          "neurology"
        ],
        "example_concepts": [
          "Type 2 diabetes mellitus",
          "Essential hypertension",
          "Acute myocardial infarction"
        ]
      },
      {
        "domain_id": "Procedure",
        "domain_name": "Procedure",
        "concept_count": 87321,
        "coverage_score": 89.7,
        "coverage_level": "Good",
        "concept_class_distribution": [
          {
            "concept_class_id": "Procedure",
            "concept_count": 67432,
            "coverage_percentage": 77.2
          },
          {
            "concept_class_id": "Intervention",
            "concept_count": 19889,
            "coverage_percentage": 22.8
          }
        ],
        "specialty_relevance": [
          "surgery",
          "cardiology",
          "radiology"
        ],
        "example_concepts": [
          "Coronary artery bypass graft",
          "Appendectomy",
          "Chest radiography"
        ]
      },
      {
        "domain_id": "Drug",
        "domain_name": "Drug",
        "concept_count": 23456,
        "coverage_score": 64.3,
        "coverage_level": "Fair",
        "concept_class_distribution": [
          {
            "concept_class_id": "Pharmaceutical / biologic product",
            "concept_count": 18734,
            "coverage_percentage": 79.9
          },
          {
            "concept_class_id": "Clinical drug",
            "concept_count": 4722,
            "coverage_percentage": 20.1
          }
        ],
        "specialty_relevance": [
          "pharmacy",
          "oncology",
          "psychiatry"
        ],
        "example_concepts": [
          "Metformin",
          "Aspirin",
          "Insulin"
        ]
      }
    ],
    "specialty_coverage": [
      {
        "specialty": "cardiology",
        "coverage_score": 94.8,
        "concept_count": 34567,
        "primary_domains": ["Condition", "Procedure", "Observation"],
        "coverage_strengths": [
          "Comprehensive cardiac conditions",
          "Extensive cardiac procedures",
          "Detailed anatomical structures"
        ],
        "coverage_gaps": [
          "Some emerging interventional techniques",
          "Limited cardiac rehabilitation concepts"
        ],
        "recommended_supplements": ["HCPCS", "ICD10PCS"]
      },
      {
        "specialty": "oncology",
        "coverage_score": 91.2,
        "concept_count": 28934,
        "primary_domains": ["Condition", "Procedure", "Drug"],
        "coverage_strengths": [
          "Comprehensive cancer classifications",
          "Extensive oncological procedures",
          "Detailed staging concepts"
        ],
        "coverage_gaps": [
          "Some immunotherapy agents",
          "Emerging precision medicine concepts"
        ],
        "recommended_supplements": ["RXNORM", "HCPCS"]
      }
    ],
    "mapping_coverage": {
      "total_mapped_concepts": 298456,
      "mapping_coverage_percentage": 84.1,
      "target_vocabulary_coverage": [
        {
          "target_vocabulary_id": "ICD10CM",
          "mapped_concepts": 89456,
          "coverage_percentage": 25.2,
          "mapping_quality_score": 87.3,
          "bidirectional_mappings": 67234
        },
        {
          "target_vocabulary_id": "LOINC",
          "mapped_concepts": 34567,
          "coverage_percentage": 9.7,
          "mapping_quality_score": 91.8,
          "bidirectional_mappings": 28934
        },
        {
          "target_vocabulary_id": "RXNORM",
          "mapped_concepts": 23456,
          "coverage_percentage": 6.6,
          "mapping_quality_score": 76.5,
          "bidirectional_mappings": 18732
        }
      ],
      "domain_mapping_coverage": [
        {
          "domain_id": "Condition",
          "mapping_percentage": 89.7
        },
        {
          "domain_id": "Procedure", 
          "mapping_percentage": 78.4
        },
        {
          "domain_id": "Drug",
          "mapping_percentage": 45.2
        }
      ]
    },
    "gap_analysis": {
      "critical_gaps": [
        {
          "area": "Pharmaceutical products",
          "domain": "Drug",
          "specialty": "pharmacy",
          "gap_severity": "High",
          "description": "Limited coverage of brand-name medications and dosage forms",
          "impact": "Reduced medication reconciliation accuracy"
        },
        {
          "area": "Laboratory procedures",
          "domain": "Measurement",
          "specialty": "pathology",
          "gap_severity": "Medium",
          "description": "Some specialized laboratory tests not well represented",
          "impact": "Limited support for specialized diagnostic workflows"
        }
      ],
      "recommended_actions": [
        {
          "action_type": "supplement_vocabulary",
          "priority": "High",
          "description": "Supplement with RXNORM for comprehensive drug coverage",
          "complementary_vocabularies": ["RXNORM", "NDC"]
        },
        {
          "action_type": "enhance_mapping",
          "priority": "Medium",
          "description": "Improve mappings to LOINC for laboratory procedures",
          "complementary_vocabularies": ["LOINC"]
        }
      ],
      "coverage_improvement_potential": 12.8
    },
    "comparison_analysis": [
      {
        "comparison_vocabulary_id": "ICD10CM",
        "overlap_percentage": 67.3,
        "unique_coverage_areas": [
          "Detailed anatomical concepts",
          "Extensive procedure classifications",
          "Rich relationship hierarchies"
        ],
        "complementary_strength": 85.7,
        "recommendation": "Excellent complement - SNOMED provides clinical detail while ICD10CM offers administrative coding"
      }
    ],
    "use_case_suitability": [
      {
        "use_case": "Electronic Health Records",
        "suitability_score": 94.2,
        "suitability_level": "Excellent",
        "supporting_factors": [
          "Comprehensive clinical terminology",
          "Rich hierarchical relationships",
          "Extensive mapping coverage"
        ],
        "limitations": [
          "Complexity may require training",
          "Some gaps in pharmaceutical coverage"
        ],
        "recommendations": [
          "Primary terminology for clinical documentation",
          "Supplement with RXNORM for medications"
        ]
      },
      {
        "use_case": "Clinical Decision Support",
        "suitability_score": 91.8,
        "suitability_level": "Excellent",
        "supporting_factors": [
          "Detailed concept relationships",
          "Hierarchical navigation support",
          "Rich semantic content"
        ],
        "limitations": [
          "Version updates may affect rules",
          "Complexity in rule maintenance"
        ],
        "recommendations": [
          "Excellent for rule-based CDS",
          "Consider version management strategy"
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_snomed_coverage_123",
    "timestamp": "2024-03-15T10:30:00Z",
    "analysis_parameters": {
      "analysis_type": "comprehensive",
      "target_domains": ["Condition", "Procedure", "Drug"],
      "include_mapping_analysis": true,
      "include_gap_recommendations": true,
      "granularity": "detailed"
    },
    "computation_time_ms": 5847,
    "vocab_release": "2025.2"
  }
}