curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/quality?assessment_type=comprehensive&include_detailed_findings=true&include_recommendations=true&include_examples=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "vocabulary_id": "SNOMED",
    "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
    "vocabulary_version": "2024.2",
    "assessment_date": "2024-01-15T10:30:00Z",
    "overall_quality": {
      "quality_score": 91.7,
      "quality_grade": "A",
      "quality_level": "Excellent",
      "total_issues_found": 1247,
      "critical_issues": 12,
      "improvement_potential": 8.3
    },
    "quality_dimensions": {
      "accuracy": {
        "score": 94.2,
        "grade": "A",
        "issues_found": 234,
        "key_findings": [
          "High accuracy in concept definitions",
          "Minor issues with some synonym assignments",
          "Excellent relationship accuracy"
        ]
      },
      "completeness": {
        "score": 89.8,
        "grade": "B+",
        "missing_data_percentage": 2.1,
        "incomplete_records": 567
      },
      "consistency": {
        "score": 92.5,
        "grade": "A-",
        "inconsistencies_found": 189,
        "pattern_violations": 45
      },
      "validity": {
        "score": 96.1,
        "grade": "A",
        "invalid_values": 67,
        "format_violations": 23
      },
      "integrity": {
        "score": 93.4,
        "grade": "A",
        "referential_integrity_issues": 89,
        "orphaned_concepts": 34
      },
      "timeliness": {
        "score": 88.2,
        "grade": "B+",
        "outdated_concepts": 234,
        "staleness_indicator": 0.12
      }
    },
    "domain_quality": [
      {
        "domain_id": "Condition",
        "domain_name": "Condition",
        "quality_score": 93.8,
        "quality_grade": "A",
        "concept_count": 125643,
        "issues_count": 456,
        "top_issues": [
          "Minor synonym inconsistencies",
          "Some missing preferred terms",
          "Rare hierarchical anomalies"
        ]
      },
      {
        "domain_id": "Procedure",
        "domain_name": "Procedure",
        "quality_score": 91.2,
        "quality_grade": "A-",
        "concept_count": 87321,
        "issues_count": 567,
        "top_issues": [
          "Inconsistent procedure classifications",
          "Missing anatomical site relationships",
          "Some outdated procedure codes"
        ]
      },
      {
        "domain_id": "Drug",
        "domain_name": "Drug",
        "quality_score": 84.6,
        "quality_grade": "B",
        "concept_count": 23456,
        "issues_count": 224,
        "top_issues": [
          "Limited pharmaceutical concept coverage",
          "Inconsistent dosage form classifications",
          "Missing drug ingredient relationships"
        ]
      }
    ],
    "detailed_findings": [
      {
        "finding_id": "SNOMED-QF-001",
        "severity": "Medium",
        "category": "Consistency",
        "issue_type": "Synonym inconsistency",
        "description": "Some concepts have synonyms that are not consistently formatted across similar concept types",
        "affected_concepts_count": 234,
        "domain_impact": ["Condition", "Procedure"],
        "example_concepts": [
          {
            "concept_id": 201826,
            "concept_name": "Type 2 diabetes mellitus",
            "specific_issue": "Synonym 'T2DM' not consistently used across diabetes concepts"
          },
          {
            "concept_id": 73211009,
            "concept_name": "Diabetes mellitus",
            "specific_issue": "Missing common abbreviation 'DM' as synonym"
          }
        ],
        "recommended_action": "Standardize synonym formatting and ensure consistency across related concepts",
        "impact_assessment": "Minor impact on search and retrieval functionality"
      },
      {
        "finding_id": "SNOMED-QF-002",
        "severity": "High",
        "category": "Integrity",
        "issue_type": "Orphaned concepts",
        "description": "Some concepts lack proper hierarchical relationships, making them difficult to navigate",
        "affected_concepts_count": 34,
        "domain_impact": ["Procedure", "Device"],
        "example_concepts": [
          {
            "concept_id": 987654321,
            "concept_name": "Specialized surgical instrument",
            "specific_issue": "Missing 'Is a' relationship to parent device concept"
          }
        ],
        "recommended_action": "Establish proper hierarchical relationships for orphaned concepts",
        "impact_assessment": "High impact on concept navigation and classification"
      },
      {
        "finding_id": "SNOMED-QF-003",
        "severity": "Critical",
        "category": "Accuracy",
        "issue_type": "Incorrect relationship",
        "description": "Some concepts have semantically incorrect relationships that could mislead users",
        "affected_concepts_count": 12,
        "domain_impact": ["Condition"],
        "example_concepts": [
          {
            "concept_id": 123456789,
            "concept_name": "Bacterial pneumonia",
            "specific_issue": "Incorrectly related to viral pneumonia as sibling concept"
          }
        ],
        "recommended_action": "Review and correct semantically incorrect relationships",
        "impact_assessment": "Critical impact on clinical decision support systems"
      }
    ],
    "validation_reports": {
      "schema_compliance": {
        "compliance_score": 98.7,
        "violations_found": 23,
        "critical_violations": 2
      },
      "standards_compliance": {
        "compliance_score": 96.4,
        "standard_violations": 45,
        "recommendation_compliance": 89.2
      },
      "business_rules": {
        "rules_passed": 156,
        "rules_failed": 8,
        "pass_rate": 95.1
      },
      "cross_references": {
        "valid_references": 99.2,
        "broken_references": 234,
        "dangling_references": 67
      }
    },
    "improvement_recommendations": [
      {
        "recommendation_id": "SNOMED-REC-001",
        "priority": "High",
        "category": "Integrity",
        "title": "Resolve orphaned concepts",
        "description": "Establish proper hierarchical relationships for concepts missing parent relationships",
        "expected_improvement": 2.3,
        "effort_level": "Medium",
        "affected_domains": ["Procedure", "Device"],
        "implementation_steps": [
          "Identify all orphaned concepts",
          "Analyze semantic context for proper placement",
          "Create appropriate 'Is a' relationships",
          "Validate new hierarchical structure"
        ]
      },
      {
        "recommendation_id": "SNOMED-REC-002",
        "priority": "Medium",
        "category": "Consistency",
        "title": "Standardize synonym formatting",
        "description": "Implement consistent synonym formatting rules across all concept types",
        "expected_improvement": 1.8,
        "effort_level": "Low",
        "affected_domains": ["Condition", "Procedure", "Drug"],
        "implementation_steps": [
          "Define synonym formatting standards",
          "Audit existing synonyms for compliance",
          "Implement automated formatting rules",
          "Update non-compliant synonyms"
        ]
      },
      {
        "recommendation_id": "SNOMED-REC-003",
        "priority": "Critical",
        "category": "Accuracy",
        "title": "Correct semantic relationships",
        "description": "Review and fix semantically incorrect concept relationships",
        "expected_improvement": 4.2,
        "effort_level": "High",
        "affected_domains": ["Condition"],
        "implementation_steps": [
          "Identify semantically incorrect relationships",
          "Engage domain experts for review",
          "Correct relationship assignments",
          "Validate changes with clinical reviewers"
        ]
      }
    ],
    "comparison_analysis": {
      "baseline_version": "2024-01",
      "quality_trend": "Improved",
      "score_change": 2.4,
      "new_issues": 89,
      "resolved_issues": 156,
      "dimension_changes": {
        "accuracy": 1.2,
        "completeness": 3.4,
        "consistency": 0.8,
        "validity": 2.1,
        "integrity": 1.9,
        "timeliness": 4.2
      }
    }
  },
  "meta": {
    "request_id": "req_snomed_quality_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "assessment_parameters": {
      "assessment_type": "comprehensive",
      "severity_threshold": "medium",
      "focus_domains": ["Condition", "Procedure", "Drug"],
      "quality_dimensions": ["accuracy", "completeness", "consistency"]
    },
    "computation_time_ms": 8947,
    "total_concepts_assessed": 354652,
    "vocab_release": "2025.2"
  }
}