Get Mapping Quality

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

{
  "success": true,
  "data": {
    "quality_overview": {
    "total_mappings_analyzed": 4578923,
    "mappings_with_quality_data": 3456789,
    "overall_average_confidence": 0.847,
    "overall_quality_rating": "good",
    "high_quality_percentage": 72.3,
    "validated_percentage": 68.9,
    "disputed_percentage": 2.7
  },
  "quality_by_vocabulary_pair": {
    "SNOMED": {
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "target_vocabularies": {
        "ICD10CM": {
          "target_vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
          "total_mappings": 156789,
          "average_confidence": 0.923,
          "median_confidence": 0.950,
          "confidence_std_dev": 0.087,
          "equivalence_distribution": {
            "exact": 89234,
            "broader": 45678,
            "narrower": 12345,
            "related": 9532
          },
          "validation_rate": 0.847,
          "quality_rating": "excellent",
          "primary_use_cases": ["billing", "quality_reporting", "clinical_documentation"]
        },
        "HCPCS": {
          "target_vocabulary_name": "Healthcare Common Procedure Coding System",
          "total_mappings": 67890,
          "average_confidence": 0.756,
          "median_confidence": 0.780,
          "confidence_std_dev": 0.145,
          "equivalence_distribution": {
            "exact": 23456,
            "broader": 34567,
            "narrower": 6789,
            "related": 3078
          },
          "validation_rate": 0.623,
          "quality_rating": "good",
          "primary_use_cases": ["billing", "procedure_coding"]
        }
      },
      "overall_outgoing_quality": 0.875
    }
  },
  "quality_by_domain": {
    "Condition": {
      "domain_name": "Condition",
      "total_mappings": 2847562,
      "average_confidence": 0.891,
      "quality_distribution": {
        "excellent": 1456789,
        "good": 987654,
        "moderate": 345678,
        "poor": 57441
      },
      "most_reliable_vocabulary_pairs": [
        "SNOMED → ICD10CM",
        "ICD10CM → SNOMED", 
        "SNOMED → ICD10"
      ],
      "least_reliable_vocabulary_pairs": [
        "Read → ICPC2",
        "Local → Standard"
      ],
      "quality_challenges": [
        "Complex conditions often map to broader categories",
        "Regional terminology variations affect consistency",
        "Rare diseases have limited mapping coverage"
      ]
    },
    "Drug": {
      "domain_name": "Drug",
      "total_mappings": 987654,
      "average_confidence": 0.823,
      "quality_distribution": {
        "excellent": 456789,
        "good": 345678,
        "moderate": 123456,
        "poor": 61731
      },
      "most_reliable_vocabulary_pairs": [
        "RxNorm → NDC",
        "NDC → RxNorm"
      ],
      "least_reliable_vocabulary_pairs": [
        "SNOMED → RxNorm",
        "Local drug codes → RxNorm"
      ],
      "quality_challenges": [
        "Generic vs brand name mapping complexity",
        "Dosage form variations affect precision",
        "Discontinued medications create gaps"
      ]
    }
  },
  "quality_metrics": {
    "confidence_score_distribution": {
      "histogram_bins": [
        {"min": 0.0, "max": 0.1, "count": 12456},
        {"min": 0.1, "max": 0.2, "count": 23456},
        {"min": 0.8, "max": 0.9, "count": 456789},
        {"min": 0.9, "max": 1.0, "count": 678901}
      ],
      "percentiles": {
        "25": 0.734,
        "50": 0.847,
        "75": 0.923,
        "95": 0.978
      },
      "skewness": -0.342,
      "kurtosis": 2.156
    },
    "semantic_similarity_analysis": {
      "average_similarity": 0.823,
      "similarity_confidence_correlation": 0.756,
      "low_similarity_high_confidence": 23456,
      "high_similarity_low_confidence": 12345
    },
    "mapping_source_analysis": {
      "official_mappings": {
        "average_confidence": 0.912,
        "total_count": 2345678,
        "validation_rate": 0.923
      },
      "community_mappings": {
        "average_confidence": 0.734,
        "total_count": 456789,
        "validation_rate": 0.456
      },
      "algorithmic_mappings": {
        "average_confidence": 0.678,
        "total_count": 567890,
        "validation_rate": 0.234
      }
    }
  },
  "quality_outliers": {
    "low_quality_outliers": [
      {
        "source_concept_id": 12345,
        "target_concept_id": 67890,
        "confidence_score": 0.123,
        "outlier_reason": "Very low confidence despite official mapping",
        "potential_issues": [
          "Semantic mismatch",
          "Outdated mapping relationship"
        ]
      }
    ],
    "outlier_patterns": [
      "Algorithmic mappings between distant concept classes",
      "Legacy mappings not updated with vocabulary revisions",
      "Cross-domain mappings with semantic drift"
    ]
  },
  "recommendations": [
    {
      "recommendation_type": "validation_review",
      "title": "Review disputed SNOMED to HCPCS mappings",
      "description": "Systematic review of 2,847 disputed mappings between SNOMED procedures and HCPCS codes to improve validation rate",
      "priority": "high",
      "expected_improvement": "Increase HCPCS mapping quality by 15-20%",
      "affected_vocabulary_pairs": ["SNOMED → HCPCS"],
      "implementation_effort": "moderate"
    },
    {
      "recommendation_type": "algorithmic_improvement", 
      "title": "Enhance semantic similarity algorithms for drug mappings",
      "description": "Improve algorithmic mapping quality between drug vocabularies using enhanced semantic similarity models",
      "priority": "medium",
      "expected_improvement": "Increase drug domain confidence by 10%",
      "affected_vocabulary_pairs": ["RxNorm → NDC", "SNOMED → RxNorm"],
      "implementation_effort": "high"
    }
  ]
  },
  "meta": {
    "request_id": "req_quality_analysis_234567",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2",
    "analysis_scope": {
      "vocabularies_included": 23,
      "domains_analyzed": 15,
      "mapping_relationships_analyzed": 4578923
    },
    "confidence_calculation_method": "weighted_semantic_similarity_with_validation"
  }
}

GET

mappings

quality

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

{
  "success": true,
  "data": {
    "quality_overview": {
    "total_mappings_analyzed": 4578923,
    "mappings_with_quality_data": 3456789,
    "overall_average_confidence": 0.847,
    "overall_quality_rating": "good",
    "high_quality_percentage": 72.3,
    "validated_percentage": 68.9,
    "disputed_percentage": 2.7
  },
  "quality_by_vocabulary_pair": {
    "SNOMED": {
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "target_vocabularies": {
        "ICD10CM": {
          "target_vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
          "total_mappings": 156789,
          "average_confidence": 0.923,
          "median_confidence": 0.950,
          "confidence_std_dev": 0.087,
          "equivalence_distribution": {
            "exact": 89234,
            "broader": 45678,
            "narrower": 12345,
            "related": 9532
          },
          "validation_rate": 0.847,
          "quality_rating": "excellent",
          "primary_use_cases": ["billing", "quality_reporting", "clinical_documentation"]
        },
        "HCPCS": {
          "target_vocabulary_name": "Healthcare Common Procedure Coding System",
          "total_mappings": 67890,
          "average_confidence": 0.756,
          "median_confidence": 0.780,
          "confidence_std_dev": 0.145,
          "equivalence_distribution": {
            "exact": 23456,
            "broader": 34567,
            "narrower": 6789,
            "related": 3078
          },
          "validation_rate": 0.623,
          "quality_rating": "good",
          "primary_use_cases": ["billing", "procedure_coding"]
        }
      },
      "overall_outgoing_quality": 0.875
    }
  },
  "quality_by_domain": {
    "Condition": {
      "domain_name": "Condition",
      "total_mappings": 2847562,
      "average_confidence": 0.891,
      "quality_distribution": {
        "excellent": 1456789,
        "good": 987654,
        "moderate": 345678,
        "poor": 57441
      },
      "most_reliable_vocabulary_pairs": [
        "SNOMED → ICD10CM",
        "ICD10CM → SNOMED", 
        "SNOMED → ICD10"
      ],
      "least_reliable_vocabulary_pairs": [
        "Read → ICPC2",
        "Local → Standard"
      ],
      "quality_challenges": [
        "Complex conditions often map to broader categories",
        "Regional terminology variations affect consistency",
        "Rare diseases have limited mapping coverage"
      ]
    },
    "Drug": {
      "domain_name": "Drug",
      "total_mappings": 987654,
      "average_confidence": 0.823,
      "quality_distribution": {
        "excellent": 456789,
        "good": 345678,
        "moderate": 123456,
        "poor": 61731
      },
      "most_reliable_vocabulary_pairs": [
        "RxNorm → NDC",
        "NDC → RxNorm"
      ],
      "least_reliable_vocabulary_pairs": [
        "SNOMED → RxNorm",
        "Local drug codes → RxNorm"
      ],
      "quality_challenges": [
        "Generic vs brand name mapping complexity",
        "Dosage form variations affect precision",
        "Discontinued medications create gaps"
      ]
    }
  },
  "quality_metrics": {
    "confidence_score_distribution": {
      "histogram_bins": [
        {"min": 0.0, "max": 0.1, "count": 12456},
        {"min": 0.1, "max": 0.2, "count": 23456},
        {"min": 0.8, "max": 0.9, "count": 456789},
        {"min": 0.9, "max": 1.0, "count": 678901}
      ],
      "percentiles": {
        "25": 0.734,
        "50": 0.847,
        "75": 0.923,
        "95": 0.978
      },
      "skewness": -0.342,
      "kurtosis": 2.156
    },
    "semantic_similarity_analysis": {
      "average_similarity": 0.823,
      "similarity_confidence_correlation": 0.756,
      "low_similarity_high_confidence": 23456,
      "high_similarity_low_confidence": 12345
    },
    "mapping_source_analysis": {
      "official_mappings": {
        "average_confidence": 0.912,
        "total_count": 2345678,
        "validation_rate": 0.923
      },
      "community_mappings": {
        "average_confidence": 0.734,
        "total_count": 456789,
        "validation_rate": 0.456
      },
      "algorithmic_mappings": {
        "average_confidence": 0.678,
        "total_count": 567890,
        "validation_rate": 0.234
      }
    }
  },
  "quality_outliers": {
    "low_quality_outliers": [
      {
        "source_concept_id": 12345,
        "target_concept_id": 67890,
        "confidence_score": 0.123,
        "outlier_reason": "Very low confidence despite official mapping",
        "potential_issues": [
          "Semantic mismatch",
          "Outdated mapping relationship"
        ]
      }
    ],
    "outlier_patterns": [
      "Algorithmic mappings between distant concept classes",
      "Legacy mappings not updated with vocabulary revisions",
      "Cross-domain mappings with semantic drift"
    ]
  },
  "recommendations": [
    {
      "recommendation_type": "validation_review",
      "title": "Review disputed SNOMED to HCPCS mappings",
      "description": "Systematic review of 2,847 disputed mappings between SNOMED procedures and HCPCS codes to improve validation rate",
      "priority": "high",
      "expected_improvement": "Increase HCPCS mapping quality by 15-20%",
      "affected_vocabulary_pairs": ["SNOMED → HCPCS"],
      "implementation_effort": "moderate"
    },
    {
      "recommendation_type": "algorithmic_improvement", 
      "title": "Enhance semantic similarity algorithms for drug mappings",
      "description": "Improve algorithmic mapping quality between drug vocabularies using enhanced semantic similarity models",
      "priority": "medium",
      "expected_improvement": "Increase drug domain confidence by 10%",
      "affected_vocabulary_pairs": ["RxNorm → NDC", "SNOMED → RxNorm"],
      "implementation_effort": "high"
    }
  ]
  },
  "meta": {
    "request_id": "req_quality_analysis_234567",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2",
    "analysis_scope": {
      "vocabularies_included": 23,
      "domains_analyzed": 15,
      "mapping_relationships_analyzed": 4578923
    },
    "confidence_calculation_method": "weighted_semantic_similarity_with_validation"
  }
}

This endpoint provides comprehensive analysis of mapping quality throughout the vocabulary ecosystem, essential for understanding the reliability of cross-vocabulary translations, identifying high-confidence mappings, and assessing the trustworthiness of mapping relationships for clinical and operational use.

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

equivalence_types

string

Filter by mapping equivalence types
Example: exact,broader,narrower,related

validation_status

string

Filter by mapping validation status
Options: validated, pending, disputed, deprecated

mapping_sources

string

Filter by mapping source types
Example: official,community,algorithmic,manual

confidence_threshold

number

default:"0.0"

Minimum confidence score for inclusion (0-1)

include_detailed_metrics

boolean

default:"true"

Include detailed quality metrics and distributions

include_outliers

boolean

default:"false"

Include analysis of quality outliers and anomalies

include_trends

boolean

default:"false"

Include historical quality trends

include_recommendations

boolean

default:"false"

Include recommendations for quality improvement

sample_size

integer

Maximum number of mappings to analyze for detailed metrics
Default: No limit

Response

quality_overview

object

High-level summary of mapping quality

Show Quality Overview Object

total_mappings_analyzed

integer

Total number of mappings included in analysis

mappings_with_quality_data

integer

Mappings that have quality metadata

overall_average_confidence

number

Overall average confidence score across all mappings

overall_quality_rating

string

Overall quality assessment
Values: excellent, good, moderate, poor

high_quality_percentage

number

Percentage of mappings with confidence > 0.8 (0-100%)

validated_percentage

number

Percentage of officially validated mappings (0-100%)

disputed_percentage

number

Percentage of disputed or problematic mappings

quality_by_vocabulary_pair

object

Quality metrics for each vocabulary pair

Show Vocabulary Pair Quality Object

[source_vocabulary_id]

object

Quality metrics for each source vocabulary

Show Source Vocabulary Quality Object

vocabulary_name

string

Human-readable vocabulary name

target_vocabularies

object

Quality metrics by target vocabulary

Show Target Vocabulary Quality Object

[target_vocabulary_id]

object

Quality metrics for this vocabulary pair

Show Pair Quality Metrics Object

target_vocabulary_name

string

Target vocabulary name

total_mappings

integer

Number of mappings between these vocabularies

average_confidence

number

Average confidence score for this pair

median_confidence

number

Median confidence score

confidence_std_dev

number

Standard deviation of confidence scores

equivalence_distribution

object

Distribution of equivalence types

validation_rate

number

Rate of validated mappings (0.0-1.0 fraction)

quality_rating

string

Quality rating for this vocabulary pair

primary_use_cases

array

Main use cases for these mappings

overall_outgoing_quality

number

Average quality of outgoing mappings

quality_by_domain

object

Quality analysis by medical domain

Show Domain Quality Object

[domain_id]

object

Quality metrics for each domain

Show Individual Domain Quality Object

domain_name

string

Human-readable domain name

total_mappings

integer

Number of mappings in this domain

average_confidence

number

Average confidence score for domain

quality_distribution

object

Distribution of quality levels

Show Quality Distribution Object

excellent

integer

Mappings with confidence score of 0.9 or higher

good

integer

Mappings with confidence score between 0.7 and 0.9

moderate

integer

Mappings with confidence score between 0.5 and 0.7

poor

integer

Mappings with confidence score below 0.5

most_reliable_vocabulary_pairs

array

Vocabulary pairs with highest quality in this domain

least_reliable_vocabulary_pairs

array

Vocabulary pairs with lowest quality in this domain

quality_challenges

array

Common quality issues in this domain

quality_metrics

object

Detailed quality metrics and distributions

Show Quality Metrics Object

confidence_score_distribution

object

Distribution of confidence scores

Show Confidence Distribution Object

histogram_bins

array

Confidence score ranges and counts

percentiles

object

Key percentile values

skewness

number

Skewness of confidence distribution

kurtosis

number

Kurtosis of confidence distribution

semantic_similarity_analysis

object

Analysis of semantic similarity scores

Show Semantic Similarity Analysis Object

average_similarity

number

Average semantic similarity score

similarity_confidence_correlation

number

Correlation between similarity and confidence

low_similarity_high_confidence

integer

Mappings with low similarity but high confidence

high_similarity_low_confidence

integer

Mappings with high similarity but low confidence

mapping_source_analysis

object

Quality breakdown by mapping source

Show Mapping Source Analysis Object

official_mappings

object

Quality metrics for official mappings

community_mappings

object

Quality metrics for community mappings

algorithmic_mappings

object

Quality metrics for algorithmic mappings

manual_mappings

object

Quality metrics for manually created mappings

validation_impact_analysis

object

Impact of validation on quality perception

Show Validation Impact Object

validated_vs_unvalidated

object

Quality comparison between validated and unvalidated

validation_accuracy

number

Accuracy of validation process

disputed_mapping_characteristics

object

Common characteristics of disputed mappings

quality_outliers

object

Analysis of quality outliers and anomalies (when include_outliers=true)

Show Quality Outliers Object

low_quality_outliers

array

Mappings with unusually low quality scores

Show Quality Outlier Object

source_concept_id

integer

Source concept identifier

target_concept_id

integer

Target concept identifier

confidence_score

number

Confidence score

outlier_reason

string

Why this is considered an outlier

potential_issues

array

Potential quality issues identified

high_quality_outliers

array

Mappings with exceptionally high quality

inconsistent_mappings

array

Mappings with inconsistent quality indicators

outlier_patterns

array

Common patterns in outlier mappings

quality_trends

object

Historical quality trends (when include_trends=true)

Show Quality Trends Object

quality_over_time

array

Time series of quality improvements

Show Quality Time Point Object

date

string

Date of measurement

average_confidence

number

Average confidence at this time

validation_rate

number

Validation rate at this time

new_mappings_quality

number

Quality of newly added mappings

quality_improvement_rate

number

Annual rate of quality improvement (0.0-1.0 fraction)

fastest_improving_areas

array

Areas with most rapid quality improvement

declining_quality_areas

array

Areas with declining quality

recommendations

array

Recommendations for quality improvement (when include_recommendations=true)

Show Quality Recommendation Object

recommendation_type

string

Type of quality improvement recommendation

title

string

Brief title of the recommendation

description

string

Detailed description

priority

string

Implementation priority

expected_improvement

string

Expected quality improvement

affected_vocabulary_pairs

array

Vocabulary pairs that would benefit

implementation_effort

string

Estimated implementation effort

meta

object

Analysis metadata and processing information

Show Metadata Object

analysis_date

string

Date when quality analysis was performed

data_freshness

string

Timestamp of underlying mapping data

analysis_scope

object

Scope of the quality analysis

calculation_time_ms

number

Time taken to perform analysis

confidence_calculation_method

string

Method used to calculate confidence scores

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

{
  "success": true,
  "data": {
    "quality_overview": {
    "total_mappings_analyzed": 4578923,
    "mappings_with_quality_data": 3456789,
    "overall_average_confidence": 0.847,
    "overall_quality_rating": "good",
    "high_quality_percentage": 72.3,
    "validated_percentage": 68.9,
    "disputed_percentage": 2.7
  },
  "quality_by_vocabulary_pair": {
    "SNOMED": {
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "target_vocabularies": {
        "ICD10CM": {
          "target_vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
          "total_mappings": 156789,
          "average_confidence": 0.923,
          "median_confidence": 0.950,
          "confidence_std_dev": 0.087,
          "equivalence_distribution": {
            "exact": 89234,
            "broader": 45678,
            "narrower": 12345,
            "related": 9532
          },
          "validation_rate": 0.847,
          "quality_rating": "excellent",
          "primary_use_cases": ["billing", "quality_reporting", "clinical_documentation"]
        },
        "HCPCS": {
          "target_vocabulary_name": "Healthcare Common Procedure Coding System",
          "total_mappings": 67890,
          "average_confidence": 0.756,
          "median_confidence": 0.780,
          "confidence_std_dev": 0.145,
          "equivalence_distribution": {
            "exact": 23456,
            "broader": 34567,
            "narrower": 6789,
            "related": 3078
          },
          "validation_rate": 0.623,
          "quality_rating": "good",
          "primary_use_cases": ["billing", "procedure_coding"]
        }
      },
      "overall_outgoing_quality": 0.875
    }
  },
  "quality_by_domain": {
    "Condition": {
      "domain_name": "Condition",
      "total_mappings": 2847562,
      "average_confidence": 0.891,
      "quality_distribution": {
        "excellent": 1456789,
        "good": 987654,
        "moderate": 345678,
        "poor": 57441
      },
      "most_reliable_vocabulary_pairs": [
        "SNOMED → ICD10CM",
        "ICD10CM → SNOMED", 
        "SNOMED → ICD10"
      ],
      "least_reliable_vocabulary_pairs": [
        "Read → ICPC2",
        "Local → Standard"
      ],
      "quality_challenges": [
        "Complex conditions often map to broader categories",
        "Regional terminology variations affect consistency",
        "Rare diseases have limited mapping coverage"
      ]
    },
    "Drug": {
      "domain_name": "Drug",
      "total_mappings": 987654,
      "average_confidence": 0.823,
      "quality_distribution": {
        "excellent": 456789,
        "good": 345678,
        "moderate": 123456,
        "poor": 61731
      },
      "most_reliable_vocabulary_pairs": [
        "RxNorm → NDC",
        "NDC → RxNorm"
      ],
      "least_reliable_vocabulary_pairs": [
        "SNOMED → RxNorm",
        "Local drug codes → RxNorm"
      ],
      "quality_challenges": [
        "Generic vs brand name mapping complexity",
        "Dosage form variations affect precision",
        "Discontinued medications create gaps"
      ]
    }
  },
  "quality_metrics": {
    "confidence_score_distribution": {
      "histogram_bins": [
        {"min": 0.0, "max": 0.1, "count": 12456},
        {"min": 0.1, "max": 0.2, "count": 23456},
        {"min": 0.8, "max": 0.9, "count": 456789},
        {"min": 0.9, "max": 1.0, "count": 678901}
      ],
      "percentiles": {
        "25": 0.734,
        "50": 0.847,
        "75": 0.923,
        "95": 0.978
      },
      "skewness": -0.342,
      "kurtosis": 2.156
    },
    "semantic_similarity_analysis": {
      "average_similarity": 0.823,
      "similarity_confidence_correlation": 0.756,
      "low_similarity_high_confidence": 23456,
      "high_similarity_low_confidence": 12345
    },
    "mapping_source_analysis": {
      "official_mappings": {
        "average_confidence": 0.912,
        "total_count": 2345678,
        "validation_rate": 0.923
      },
      "community_mappings": {
        "average_confidence": 0.734,
        "total_count": 456789,
        "validation_rate": 0.456
      },
      "algorithmic_mappings": {
        "average_confidence": 0.678,
        "total_count": 567890,
        "validation_rate": 0.234
      }
    }
  },
  "quality_outliers": {
    "low_quality_outliers": [
      {
        "source_concept_id": 12345,
        "target_concept_id": 67890,
        "confidence_score": 0.123,
        "outlier_reason": "Very low confidence despite official mapping",
        "potential_issues": [
          "Semantic mismatch",
          "Outdated mapping relationship"
        ]
      }
    ],
    "outlier_patterns": [
      "Algorithmic mappings between distant concept classes",
      "Legacy mappings not updated with vocabulary revisions",
      "Cross-domain mappings with semantic drift"
    ]
  },
  "recommendations": [
    {
      "recommendation_type": "validation_review",
      "title": "Review disputed SNOMED to HCPCS mappings",
      "description": "Systematic review of 2,847 disputed mappings between SNOMED procedures and HCPCS codes to improve validation rate",
      "priority": "high",
      "expected_improvement": "Increase HCPCS mapping quality by 15-20%",
      "affected_vocabulary_pairs": ["SNOMED → HCPCS"],
      "implementation_effort": "moderate"
    },
    {
      "recommendation_type": "algorithmic_improvement", 
      "title": "Enhance semantic similarity algorithms for drug mappings",
      "description": "Improve algorithmic mapping quality between drug vocabularies using enhanced semantic similarity models",
      "priority": "medium",
      "expected_improvement": "Increase drug domain confidence by 10%",
      "affected_vocabulary_pairs": ["RxNorm → NDC", "SNOMED → RxNorm"],
      "implementation_effort": "high"
    }
  ]
  },
  "meta": {
    "request_id": "req_quality_analysis_234567",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2",
    "analysis_scope": {
      "vocabularies_included": 23,
      "domains_analyzed": 15,
      "mapping_relationships_analyzed": 4578923
    },
    "confidence_calculation_method": "weighted_semantic_similarity_with_validation"
  }
}

Usage Examples

Overall Quality Assessment

Get comprehensive quality overview:

const quality = await fetch('/v1/mappings/quality');

Domain-Specific Quality Analysis

Analyze quality for clinical domains:

const clinicalQuality = await fetch('/v1/mappings/quality?domain_ids=Condition,Drug,Procedure&include_detailed_metrics=true');

High-Confidence Mappings Only

Analyze only high-quality mappings:

const highQuality = await fetch('/v1/mappings/quality?confidence_threshold=0.8&include_outliers=true');

Vocabulary Pair Quality

Focus on specific vocabulary relationships:

const vocabQuality = await fetch('/v1/mappings/quality?source_vocabularies=SNOMED&target_vocabularies=ICD10CM,HCPCS&include_recommendations=true');

Quality Trend Analysis

Get historical quality trends:

const trendAnalysis = await fetch('/v1/mappings/quality?include_trends=true&include_recommendations=true');

Get Concept Mappings - Individual concept mapping quality
Get Vocabulary Mappings - Quality within vocabulary pairs
Get Mapping Coverage - Coverage vs quality analysis
Bulk Concept Mappings - Quality in bulk operations

Notes

Quality analysis requires substantial computational resources for large datasets
Confidence scores are calculated using multiple factors including semantic similarity and validation status
Official mappings generally have higher quality than algorithmic or community mappings
Quality can vary significantly between vocabulary pairs and domains
Disputed mappings may indicate areas needing expert review
Quality trends help identify improvement or degradation over time
Outlier analysis reveals mappings that may need special attention
Quality thresholds help focus on the most reliable mappings for production use

Get Mapping Coverage Bulk Concept Mappings

⌘I

API Reference

Concepts

Concept Hierarchy

Search

Search (Coming Soon)

Relationships

Domains & Classifications

Mappings

Vocabularies

Query Parameters

Response

Usage Examples

Overall Quality Assessment

Domain-Specific Quality Analysis

High-Confidence Mappings Only

Vocabulary Pair Quality

Quality Trend Analysis

Notes

API Reference

Concepts

Concept Hierarchy

Search

Search (Coming Soon)

Relationships

Domains & Classifications

Mappings

Vocabularies

​Query Parameters

​Response

​Usage Examples

​Overall Quality Assessment

​Domain-Specific Quality Analysis

​High-Confidence Mappings Only

​Vocabulary Pair Quality

​Quality Trend Analysis

​Related Endpoints

​Notes

Query Parameters

Response

Usage Examples

Overall Quality Assessment

Domain-Specific Quality Analysis

High-Confidence Mappings Only

Vocabulary Pair Quality

Quality Trend Analysis

Related Endpoints

Notes