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"
}
}
Validate the accuracy and quality of concept mappings between vocabularies
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"
}
}
Show mappings
Show validation_options
Show data
Show validation_results
Show validation_checks
Show domain_compatibility
Show alternative_mappings
Show validation_summary
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"
}
}
{
"mappings": [
{
"source_concept_id": 201826,
"target_concept_id": 443735,
"mapping_type": "Maps to"
}
]
}
{
"mappings": [
{
"source_concept_id": 201826,
"target_concept_id": 443735,
"mapping_type": "Maps to",
"expected_confidence": 0.85
}
],
"validation_options": {
"check_semantic_similarity": true,
"check_domain_compatibility": true,
"check_temporal_validity": true,
"check_vocabulary_standards": true,
"include_alternative_mappings": true,
"confidence_threshold": 0.8
}
}
{
"mappings": [
{
"source_concept_id": 201826,
"target_concept_id": 443735,
"mapping_type": "Maps to",
"context_id": "diabetes_outcome_study_2024",
"expected_confidence": 0.9
}
],
"validation_options": {
"confidence_threshold": 0.85,
"include_alternative_mappings": true
}
}
Was this page helpful?