Skip to main content
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/statistics?include_hierarchy_stats=true&include_domain_breakdown=true&include_mapping_stats=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",
    "analysis_date": "2024-01-15T10:30:00Z",
    "concept_statistics": {
      "total_concepts": 354652,
      "standard_concepts": 298456,
      "classification_concepts": 56196,
      "non_standard_concepts": 0,
      "invalid_concepts": 1247,
      "concept_growth_rate": 2.8
    },
    "hierarchy_statistics": {
      "max_hierarchy_depth": 15,
      "average_depth": 6.8,
      "root_concepts": 19,
      "leaf_concepts": 187432,
      "depth_distribution": [
        { "depth": 1, "concept_count": 19 },
        { "depth": 2, "concept_count": 156 },
        { "depth": 3, "concept_count": 1247 },
        { "depth": 4, "concept_count": 8934 },
        { "depth": 5, "concept_count": 23567 },
        { "depth": 6, "concept_count": 45123 },
        { "depth": 7, "concept_count": 67834 },
        { "depth": 8, "concept_count": 89456 },
        { "depth": 9, "concept_count": 67234 },
        { "depth": 10, "concept_count": 34567 },
        { "depth": 11, "concept_count": 12345 },
        { "depth": 12, "concept_count": 3456 },
        { "depth": 13, "concept_count": 567 },
        { "depth": 14, "concept_count": 123 },
        { "depth": 15, "concept_count": 24 }
      ]
    },
    "domain_statistics": {
      "domains_covered": 18,
      "domain_distribution": [
        {
          "domain_id": "Condition",
          "domain_name": "Condition",
          "concept_count": 125643,
          "percentage": 35.4
        },
        {
          "domain_id": "Procedure",
          "domain_name": "Procedure",
          "concept_count": 87321,
          "percentage": 24.6
        },
        {
          "domain_id": "Observation",
          "domain_name": "Observation",
          "concept_count": 65432,
          "percentage": 18.4
        },
        {
          "domain_id": "Measurement",
          "domain_name": "Measurement",
          "concept_count": 34567,
          "percentage": 9.7
        },
        {
          "domain_id": "Drug",
          "domain_name": "Drug",
          "concept_count": 23456,
          "percentage": 6.6
        }
      ]
    },
    "concept_class_statistics": {
      "total_concept_classes": 24,
      "class_distribution": [
        {
          "concept_class_id": "Clinical Finding",
          "concept_count": 89567,
          "percentage": 25.3
        },
        {
          "concept_class_id": "Procedure",
          "concept_count": 67432,
          "percentage": 19.0
        },
        {
          "concept_class_id": "Body Structure",
          "concept_count": 45678,
          "percentage": 12.9
        }
      ]
    },
    "relationship_statistics": {
      "total_relationships": 1247832,
      "unique_relationship_types": 15,
      "relationship_type_distribution": [
        {
          "relationship_id": "Is a",
          "relationship_name": "Is a",
          "count": 567834,
          "percentage": 45.5
        },
        {
          "relationship_id": "Finding site",
          "relationship_name": "Finding site",
          "count": 123456,
          "percentage": 9.9
        },
        {
          "relationship_id": "Procedure site",
          "relationship_name": "Procedure site",
          "count": 98765,
          "percentage": 7.9
        }
      ]
    },
    "mapping_statistics": {
      "mapped_concepts": 298456,
      "unmapped_concepts": 56196,
      "mapping_coverage_percentage": 84.1,
      "target_vocabularies": [
        {
          "target_vocabulary_id": "ICD10CM",
          "mapping_count": 89456,
          "coverage_percentage": 25.2
        },
        {
          "target_vocabulary_id": "ICD10",
          "mapping_count": 67234,
          "coverage_percentage": 19.0
        },
        {
          "target_vocabulary_id": "LOINC",
          "mapping_count": 34567,
          "coverage_percentage": 9.7
        }
      ]
    },
    "language_statistics": {
      "supported_languages": ["en-US", "en-GB", "es-ES", "fr-FR", "de-DE"],
      "primary_language": "en-US",
      "multilingual_concepts": 234567
    },
    "quality_metrics": {
      "completeness_score": 94.2,
      "consistency_score": 97.8,
      "accuracy_indicators": {
        "orphaned_concepts": 234,
        "duplicate_codes": 12,
        "missing_descriptions": 89
      }
    },
    "trend_data": [
      {
        "period": "2024-Q1",
        "total_concepts": 354652,
        "concepts_added": 2847,
        "concepts_modified": 1523,
        "concepts_deprecated": 89
      },
      {
        "period": "2023-Q4",
        "total_concepts": 351805,
        "concepts_added": 1967,
        "concepts_modified": 2134,
        "concepts_deprecated": 156
      }
    ]
  },
  "meta": {
    "request_id": "req_snomed_stats_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "computation_time_ms": 2847,
    "vocab_release": "2025.2"
  }
}

Overview

This endpoint provides detailed statistical information about a vocabulary’s concept distribution, hierarchical structure, domain coverage, and usage patterns. It includes advanced metrics like hierarchy depth analysis, concept class distribution, and mapping statistics.

Path Parameters

vocabularyId
string
required
The unique identifier for the vocabulary (e.g., “SNOMED”, “ICD10CM”, “LOINC”)

Query Parameters

include_hierarchy_stats
boolean
default:"false"
Include detailed hierarchy statistics
include_domain_breakdown
boolean
default:"false"
Include domain-wise concept distribution
include_mapping_stats
boolean
default:"false"
Include mapping relationship statistics
include_trend_data
boolean
default:"false"
Include historical trend data
vocab_release
string
Specific vocabulary release version (defaults to latest)

Response

success
boolean
Indicates if the request was successful
data
object
meta
object
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/statistics?include_hierarchy_stats=true&include_domain_breakdown=true&include_mapping_stats=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",
    "analysis_date": "2024-01-15T10:30:00Z",
    "concept_statistics": {
      "total_concepts": 354652,
      "standard_concepts": 298456,
      "classification_concepts": 56196,
      "non_standard_concepts": 0,
      "invalid_concepts": 1247,
      "concept_growth_rate": 2.8
    },
    "hierarchy_statistics": {
      "max_hierarchy_depth": 15,
      "average_depth": 6.8,
      "root_concepts": 19,
      "leaf_concepts": 187432,
      "depth_distribution": [
        { "depth": 1, "concept_count": 19 },
        { "depth": 2, "concept_count": 156 },
        { "depth": 3, "concept_count": 1247 },
        { "depth": 4, "concept_count": 8934 },
        { "depth": 5, "concept_count": 23567 },
        { "depth": 6, "concept_count": 45123 },
        { "depth": 7, "concept_count": 67834 },
        { "depth": 8, "concept_count": 89456 },
        { "depth": 9, "concept_count": 67234 },
        { "depth": 10, "concept_count": 34567 },
        { "depth": 11, "concept_count": 12345 },
        { "depth": 12, "concept_count": 3456 },
        { "depth": 13, "concept_count": 567 },
        { "depth": 14, "concept_count": 123 },
        { "depth": 15, "concept_count": 24 }
      ]
    },
    "domain_statistics": {
      "domains_covered": 18,
      "domain_distribution": [
        {
          "domain_id": "Condition",
          "domain_name": "Condition",
          "concept_count": 125643,
          "percentage": 35.4
        },
        {
          "domain_id": "Procedure",
          "domain_name": "Procedure",
          "concept_count": 87321,
          "percentage": 24.6
        },
        {
          "domain_id": "Observation",
          "domain_name": "Observation",
          "concept_count": 65432,
          "percentage": 18.4
        },
        {
          "domain_id": "Measurement",
          "domain_name": "Measurement",
          "concept_count": 34567,
          "percentage": 9.7
        },
        {
          "domain_id": "Drug",
          "domain_name": "Drug",
          "concept_count": 23456,
          "percentage": 6.6
        }
      ]
    },
    "concept_class_statistics": {
      "total_concept_classes": 24,
      "class_distribution": [
        {
          "concept_class_id": "Clinical Finding",
          "concept_count": 89567,
          "percentage": 25.3
        },
        {
          "concept_class_id": "Procedure",
          "concept_count": 67432,
          "percentage": 19.0
        },
        {
          "concept_class_id": "Body Structure",
          "concept_count": 45678,
          "percentage": 12.9
        }
      ]
    },
    "relationship_statistics": {
      "total_relationships": 1247832,
      "unique_relationship_types": 15,
      "relationship_type_distribution": [
        {
          "relationship_id": "Is a",
          "relationship_name": "Is a",
          "count": 567834,
          "percentage": 45.5
        },
        {
          "relationship_id": "Finding site",
          "relationship_name": "Finding site",
          "count": 123456,
          "percentage": 9.9
        },
        {
          "relationship_id": "Procedure site",
          "relationship_name": "Procedure site",
          "count": 98765,
          "percentage": 7.9
        }
      ]
    },
    "mapping_statistics": {
      "mapped_concepts": 298456,
      "unmapped_concepts": 56196,
      "mapping_coverage_percentage": 84.1,
      "target_vocabularies": [
        {
          "target_vocabulary_id": "ICD10CM",
          "mapping_count": 89456,
          "coverage_percentage": 25.2
        },
        {
          "target_vocabulary_id": "ICD10",
          "mapping_count": 67234,
          "coverage_percentage": 19.0
        },
        {
          "target_vocabulary_id": "LOINC",
          "mapping_count": 34567,
          "coverage_percentage": 9.7
        }
      ]
    },
    "language_statistics": {
      "supported_languages": ["en-US", "en-GB", "es-ES", "fr-FR", "de-DE"],
      "primary_language": "en-US",
      "multilingual_concepts": 234567
    },
    "quality_metrics": {
      "completeness_score": 94.2,
      "consistency_score": 97.8,
      "accuracy_indicators": {
        "orphaned_concepts": 234,
        "duplicate_codes": 12,
        "missing_descriptions": 89
      }
    },
    "trend_data": [
      {
        "period": "2024-Q1",
        "total_concepts": 354652,
        "concepts_added": 2847,
        "concepts_modified": 1523,
        "concepts_deprecated": 89
      },
      {
        "period": "2023-Q4",
        "total_concepts": 351805,
        "concepts_added": 1967,
        "concepts_modified": 2134,
        "concepts_deprecated": 156
      }
    ]
  },
  "meta": {
    "request_id": "req_snomed_stats_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "computation_time_ms": 2847,
    "vocab_release": "2025.2"
  }
}

Usage Examples

Basic Statistics

Get overview statistics for a vocabulary:
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/statistics" \
  -H "Authorization: Bearer YOUR_API_KEY"

Comprehensive Analysis

Get complete statistical analysis:
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/statistics?include_hierarchy_stats=true&include_domain_breakdown=true&include_mapping_stats=true&include_trend_data=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Specific Version Analysis

Get statistics for a specific vocabulary version:
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/statistics?vocab_release=2024-01&include_hierarchy_stats=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Multiple Vocabularies Comparison

Compare statistics across vocabularies:
curl -X GET "https://api.omophub.com/v1/vocabularies/ICD10CM/statistics?include_domain_breakdown=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Statistical Insights

Hierarchy Analysis

  • Depth Distribution: Understanding concept organization depth
  • Root vs Leaf Concepts: Balance between top-level and specific concepts
  • Average Depth: Measure of hierarchical complexity

Domain Coverage

  • Primary Domains: Major clinical areas covered
  • Domain Distribution: Balance across medical specialties
  • Coverage Gaps: Areas with limited concept coverage

Quality Indicators

  • Completeness Score: Measure of data completeness
  • Consistency Score: Internal consistency metrics
  • Mapping Coverage: Interoperability with other vocabularies

Trend Analysis

  • Growth Rate: Vocabulary expansion over time
  • Change Patterns: Addition vs modification vs deprecation patterns
  • Version Comparison: Evolution across releases
I