curl -X POST "https://api.omophub.com/v1/mappings/validate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mappings": [
      {
        "source_concept_id": 201826,
        "target_concept_id": 443735,
        "mapping_type": "Maps to",
        "context_id": "diabetes_mapping_validation"
      },
      {
        "source_concept_id": 4182210,
        "target_concept_id": 320128,
        "mapping_type": "Maps to",
        "expected_confidence": 0.9
      }
    ],
    "validation_options": {
      "check_semantic_similarity": true,
      "check_domain_compatibility": true,
      "include_alternative_mappings": true,
      "confidence_threshold": 0.75
    }
  }'

{
  "success": true,
  "data": {
    "validation_results": [
      {
        "source_concept_id": 201826,
        "target_concept_id": 443735,
        "mapping_type": "Maps to",
        "context_id": "diabetes_mapping_validation",
        "is_valid": true,
        "validation_score": 0.92,
        "confidence_score": 0.89,
        "validation_checks": {
          "semantic_similarity": {
            "passed": true,
            "score": 0.94,
            "threshold": 0.75,
            "explanation": "Both concepts represent Type 2 diabetes with very high semantic overlap"
          },
          "domain_compatibility": {
            "passed": true,
            "source_domain": "Condition",
            "target_domain": "Condition",
            "compatibility_level": "exact",
            "explanation": "Both concepts belong to the same domain (Condition)"
          },
          "temporal_validity": {
            "passed": true,
            "source_validity_period": {
              "start": "2002-01-31",
              "end": "2099-12-31"
            },
            "target_validity_period": {
              "start": "2015-10-01",
              "end": "2099-12-31"
            },
            "overlap_period": {
              "start": "2015-10-01",
              "end": "2099-12-31"
            },
            "issues": []
          },
          "vocabulary_standards": {
            "passed": true,
            "source_vocabulary_standards": ["SNOMED CT", "OMOP CDM"],
            "target_vocabulary_standards": ["ICD-10-CM", "OMOP CDM"],
            "violations": []
          }
        },
        "issues": [],
        "alternative_mappings": [],
        "source_concept_details": {
          "concept_name": "Type 2 diabetes mellitus",
          "vocabulary_id": "SNOMED",
          "domain_id": "Condition",
          "concept_class_id": "Clinical Finding"
        },
        "target_concept_details": {
          "concept_name": "Type 2 diabetes mellitus without complications",
          "vocabulary_id": "ICD10CM",
          "domain_id": "Condition",
          "concept_class_id": "4-char billing code"
        }
      },
      {
        "source_concept_id": 4182210,
        "target_concept_id": 320128,
        "mapping_type": "Maps to",
        "context_id": null,
        "is_valid": false,
        "validation_score": 0.45,
        "confidence_score": 0.52,
        "validation_checks": {
          "semantic_similarity": {
            "passed": false,
            "score": 0.62,
            "threshold": 0.75,
            "explanation": "Concepts have moderate semantic similarity but below threshold"
          },
          "domain_compatibility": {
            "passed": true,
            "source_domain": "Condition",
            "target_domain": "Condition",
            "compatibility_level": "exact",
            "explanation": "Both concepts belong to the same domain"
          },
          "temporal_validity": {
            "passed": true,
            "source_validity_period": {
              "start": "2002-01-31",
              "end": "2099-12-31"
            },
            "target_validity_period": {
              "start": "2002-01-31",
              "end": "2099-12-31"
            },
            "overlap_period": {
              "start": "2002-01-31",
              "end": "2099-12-31"
            },
            "issues": []
          },
          "vocabulary_standards": {
            "passed": false,
            "source_vocabulary_standards": ["SNOMED CT"],
            "target_vocabulary_standards": ["SNOMED CT"],
            "violations": ["Same vocabulary self-mapping without proper justification"]
          }
        },
        "issues": [
          {
            "severity": "warning",
            "code": "LOW_SEMANTIC_SIMILARITY",
            "message": "Semantic similarity score (0.62) is below the confidence threshold (0.75)",
            "check_type": "semantic_similarity",
            "recommendation": "Consider using a more semantically similar target concept or review the mapping rationale"
          },
          {
            "severity": "error",
            "code": "VOCABULARY_STANDARD_VIOLATION",
            "message": "Same vocabulary mapping without proper hierarchical relationship",
            "check_type": "vocabulary_standards",
            "recommendation": "Use 'Is a' or 'Subsumes' relationship for intra-vocabulary mappings"
          }
        ],
        "alternative_mappings": [
          {
            "concept_id": 312327,
            "concept_name": "Essential hypertension",
            "vocabulary_id": "ICD10CM",
            "confidence_score": 0.85,
            "mapping_type": "Maps to",
            "rationale": "Better cross-vocabulary mapping with higher semantic similarity"
          }
        ]
      }
    ],
    "validation_summary": {
      "total_mappings": 2,
      "valid_mappings": 1,
      "invalid_mappings": 1,
      "validation_rate": 50.0,
      "average_confidence": 0.705,
      "average_validation_score": 0.685,
      "common_issues": [
        {
          "code": "LOW_SEMANTIC_SIMILARITY",
          "message": "Semantic similarity below threshold",
          "frequency": 1
        },
        {
          "code": "VOCABULARY_STANDARD_VIOLATION",
          "message": "Vocabulary standard violation",
          "frequency": 1
        }
      ],
      "processing_time_ms": 1847
    }
  },
  "meta": {
    "request_id": "req_validate_mappings_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}