Skip to main content
GET
/
v1
/
domains
/
{domain_id}
/
statistics
curl -X GET "https://api.omophub.com/v1/domains/Condition/statistics?include_growth_trends=true&include_usage_analytics=true&time_period=5y" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "domain": {
    "domain_id": "Condition",
    "domain_name": "Condition",
    "description": "Medical conditions, diseases, disorders, and clinical findings",
    "category": "clinical"
  },
  "overview_statistics": {
    "total_concepts": 845672,
    "standard_concepts": 423891,
    "classification_concepts": 89234,
    "non_standard_concepts": 332547,
    "active_concepts": 812456,
    "deprecated_concepts": 33216,
    "unique_vocabularies": 12,
    "unique_concept_classes": 45
  },
  "vocabulary_distribution": {
    "SNOMED": {
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "total_concepts": 387421,
      "standard_concepts": 298456,
      "percentage_of_domain": 45.8,
      "concept_classes": ["Clinical Finding", "Disorder", "Morphologic Abnormality"],
      "average_relationships_per_concept": 4.7
    },
    "ICD10CM": {
      "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
      "total_concepts": 98234,
      "standard_concepts": 67891,
      "percentage_of_domain": 11.6,
      "concept_classes": ["3-char billing code", "4-char billing code", "5-char billing code"],
      "average_relationships_per_concept": 2.3
    },
    "ICD10": {
      "vocabulary_name": "International Classification of Diseases, Tenth Revision",
      "total_concepts": 87456,
      "standard_concepts": 45678,
      "percentage_of_domain": 10.3,
      "concept_classes": ["ICD10 code"],
      "average_relationships_per_concept": 1.8
    }
  },
  "concept_class_breakdown": {
    "Clinical Finding": {
      "concept_class_name": "Clinical Finding",
      "total_concepts": 425891,
      "standard_concepts": 298456,
      "primary_vocabularies": ["SNOMED"],
      "percentage_of_domain": 50.4,
      "hierarchical_depth": {
        "average_depth": 5.2,
        "max_depth": 12,
        "concepts_at_root_level": 23
      }
    },
    "Disorder": {
      "concept_class_name": "Disorder", 
      "total_concepts": 234567,
      "standard_concepts": 89234,
      "primary_vocabularies": ["SNOMED"],
      "percentage_of_domain": 27.7,
      "hierarchical_depth": {
        "average_depth": 4.8,
        "max_depth": 10,
        "concepts_at_root_level": 15
      }
    }
  },
  "relationship_analysis": {
    "total_relationships": 3847562,
    "relationships_per_concept": {
      "average": 4.5,
      "median": 3.0,
      "max": 247,
      "min": 0
    },
    "relationship_type_distribution": {
      "Is a": 1845632,
      "Maps to": 967234,
      "Associated morphology": 445891,
      "Finding site": 234567,
      "Has associated finding": 123456
    },
    "cross_vocabulary_mappings": {
      "total_mappings": 967234,
      "vocabulary_pairs": {
        "SNOMED->ICD10CM": 345678,
        "SNOMED->ICD10": 234567,
        "ICD10CM->ICD10": 123456
      },
      "unmapped_concepts": 78542
    },
    "hierarchy_connectivity": {
      "connected_components": 5,
      "largest_hierarchy_size": 387421,
      "orphaned_concepts": 12456
    }
  },
  "growth_trends": {
    "annual_growth_rate": 2.8,
    "vocabulary_growth_rates": {
      "SNOMED": 3.2,
      "ICD10CM": 1.1,
      "ICD10": 0.3
    },
    "recent_additions": {
      "last_30_days": 1247,
      "last_90_days": 4892,
      "last_year": 23654,
      "top_contributing_vocabularies": ["SNOMED", "ICD10CM", "Read"]
    },
    "time_series": [
      {
        "date": "2020-01-01T00:00:00Z",
        "total_concepts": 765432,
        "concepts_added": 18234,
        "concepts_deprecated": 2456
      },
      {
        "date": "2021-01-01T00:00:00Z",
        "total_concepts": 789456,
        "concepts_added": 24024,
        "concepts_deprecated": 2789
      },
      {
        "date": "2022-01-01T00:00:00Z",
        "total_concepts": 812456,
        "concepts_added": 23000,
        "concepts_deprecated": 3234
      }
    ]
  },
  "usage_analytics": {
    "query_frequency": {
      "daily_average": 15847.3,
      "monthly_trend": [14523, 15234, 16789, 15647, 16234],
      "peak_usage_hours": [9, 10, 11, 14, 15]
    },
    "most_accessed_concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "vocabulary_id": "SNOMED",
        "access_count": 89234
      },
      {
        "concept_id": 320128,
        "concept_name": "Essential hypertension",
        "vocabulary_id": "SNOMED",
        "access_count": 76543
      }
    ],
    "search_patterns": {
      "common_search_terms": ["diabetes", "hypertension", "pneumonia", "depression", "arthritis"],
      "search_success_rate": 0.87,
      "average_results_per_search": 23.4
    },
    "analysis_info": {
      "analysis_date": "2024-12-22T10:00:00Z",
      "data_freshness": "2024-12-22T08:30:00Z",
      "calculation_time_ms": 2847.5,
      "included_filters": {
        "active_only": false,
        "include_active": true,
        "include_deprecated": true,
        "time_period": "5y"
      }
    }
    }
  },
  "meta": {
    "request_id": "req_domain_stats_123",
    "timestamp": "2024-12-22T10:30:00Z",
    "vocab_release": "2025.2"
  }
}
This endpoint provides detailed statistical analysis for a specific domain, including concept counts, vocabulary distributions, growth trends, relationship patterns, and usage analytics. It’s essential for understanding domain characteristics and planning vocabulary integration strategies.

​
Path Parameters

​
domain_id
string
required
The domain identifier to retrieve statistics for
Example: Condition, Drug, Procedure

​
Query Parameters

​
vocabulary_ids
string
Filter statistics to specific vocabularies within the domain
Example: SNOMED,ICD10CM,RxNorm
​
time_period
string
default:"all"
Time period for trend analysis
Options: 1y, 2y, 5y, 10y, all
​
include_concept_class_breakdown
boolean
default:"true"
Include detailed breakdown by concept class
​
include_relationship_analysis
boolean
default:"true"
Include relationship pattern analysis
​
include_growth_trends
boolean
default:"true"
Include historical growth trend analysis
​
include_usage_analytics
boolean
default:"false"
Include usage pattern analytics and query statistics
​
standard_only
boolean
default:"false"
Calculate statistics for standard concepts only
​
active_only
boolean
default:"false"
Only include active concepts in statistics (defaults to false)

​
Response

​
domain
object
Domain identification and basic information
​
overview_statistics
object
High-level statistical overview of the domain
​
vocabulary_distribution
object
Statistical breakdown by vocabulary
​
concept_class_breakdown
object
Detailed breakdown by concept class (when include_concept_class_breakdown=true)
​
relationship_analysis
object
Analysis of relationship patterns (when include_relationship_analysis=true)
​
growth_trends
object
Historical growth and change analysis (when include_growth_trends=true)
​
usage_analytics
object
Usage pattern analytics (when include_usage_analytics=true)
​
meta
object
Response metadata and analysis information
curl -X GET "https://api.omophub.com/v1/domains/Condition/statistics?include_growth_trends=true&include_usage_analytics=true&time_period=5y" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "domain": {
    "domain_id": "Condition",
    "domain_name": "Condition",
    "description": "Medical conditions, diseases, disorders, and clinical findings",
    "category": "clinical"
  },
  "overview_statistics": {
    "total_concepts": 845672,
    "standard_concepts": 423891,
    "classification_concepts": 89234,
    "non_standard_concepts": 332547,
    "active_concepts": 812456,
    "deprecated_concepts": 33216,
    "unique_vocabularies": 12,
    "unique_concept_classes": 45
  },
  "vocabulary_distribution": {
    "SNOMED": {
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "total_concepts": 387421,
      "standard_concepts": 298456,
      "percentage_of_domain": 45.8,
      "concept_classes": ["Clinical Finding", "Disorder", "Morphologic Abnormality"],
      "average_relationships_per_concept": 4.7
    },
    "ICD10CM": {
      "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
      "total_concepts": 98234,
      "standard_concepts": 67891,
      "percentage_of_domain": 11.6,
      "concept_classes": ["3-char billing code", "4-char billing code", "5-char billing code"],
      "average_relationships_per_concept": 2.3
    },
    "ICD10": {
      "vocabulary_name": "International Classification of Diseases, Tenth Revision",
      "total_concepts": 87456,
      "standard_concepts": 45678,
      "percentage_of_domain": 10.3,
      "concept_classes": ["ICD10 code"],
      "average_relationships_per_concept": 1.8
    }
  },
  "concept_class_breakdown": {
    "Clinical Finding": {
      "concept_class_name": "Clinical Finding",
      "total_concepts": 425891,
      "standard_concepts": 298456,
      "primary_vocabularies": ["SNOMED"],
      "percentage_of_domain": 50.4,
      "hierarchical_depth": {
        "average_depth": 5.2,
        "max_depth": 12,
        "concepts_at_root_level": 23
      }
    },
    "Disorder": {
      "concept_class_name": "Disorder", 
      "total_concepts": 234567,
      "standard_concepts": 89234,
      "primary_vocabularies": ["SNOMED"],
      "percentage_of_domain": 27.7,
      "hierarchical_depth": {
        "average_depth": 4.8,
        "max_depth": 10,
        "concepts_at_root_level": 15
      }
    }
  },
  "relationship_analysis": {
    "total_relationships": 3847562,
    "relationships_per_concept": {
      "average": 4.5,
      "median": 3.0,
      "max": 247,
      "min": 0
    },
    "relationship_type_distribution": {
      "Is a": 1845632,
      "Maps to": 967234,
      "Associated morphology": 445891,
      "Finding site": 234567,
      "Has associated finding": 123456
    },
    "cross_vocabulary_mappings": {
      "total_mappings": 967234,
      "vocabulary_pairs": {
        "SNOMED->ICD10CM": 345678,
        "SNOMED->ICD10": 234567,
        "ICD10CM->ICD10": 123456
      },
      "unmapped_concepts": 78542
    },
    "hierarchy_connectivity": {
      "connected_components": 5,
      "largest_hierarchy_size": 387421,
      "orphaned_concepts": 12456
    }
  },
  "growth_trends": {
    "annual_growth_rate": 2.8,
    "vocabulary_growth_rates": {
      "SNOMED": 3.2,
      "ICD10CM": 1.1,
      "ICD10": 0.3
    },
    "recent_additions": {
      "last_30_days": 1247,
      "last_90_days": 4892,
      "last_year": 23654,
      "top_contributing_vocabularies": ["SNOMED", "ICD10CM", "Read"]
    },
    "time_series": [
      {
        "date": "2020-01-01T00:00:00Z",
        "total_concepts": 765432,
        "concepts_added": 18234,
        "concepts_deprecated": 2456
      },
      {
        "date": "2021-01-01T00:00:00Z",
        "total_concepts": 789456,
        "concepts_added": 24024,
        "concepts_deprecated": 2789
      },
      {
        "date": "2022-01-01T00:00:00Z",
        "total_concepts": 812456,
        "concepts_added": 23000,
        "concepts_deprecated": 3234
      }
    ]
  },
  "usage_analytics": {
    "query_frequency": {
      "daily_average": 15847.3,
      "monthly_trend": [14523, 15234, 16789, 15647, 16234],
      "peak_usage_hours": [9, 10, 11, 14, 15]
    },
    "most_accessed_concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "vocabulary_id": "SNOMED",
        "access_count": 89234
      },
      {
        "concept_id": 320128,
        "concept_name": "Essential hypertension",
        "vocabulary_id": "SNOMED",
        "access_count": 76543
      }
    ],
    "search_patterns": {
      "common_search_terms": ["diabetes", "hypertension", "pneumonia", "depression", "arthritis"],
      "search_success_rate": 0.87,
      "average_results_per_search": 23.4
    },
    "analysis_info": {
      "analysis_date": "2024-12-22T10:00:00Z",
      "data_freshness": "2024-12-22T08:30:00Z",
      "calculation_time_ms": 2847.5,
      "included_filters": {
        "active_only": false,
        "include_active": true,
        "include_deprecated": true,
        "time_period": "5y"
      }
    }
    }
  },
  "meta": {
    "request_id": "req_domain_stats_123",
    "timestamp": "2024-12-22T10:30:00Z",
    "vocab_release": "2025.2"
  }
}

​
Usage Examples

​
Basic Domain Statistics

Get overview statistics for a domain: 
const stats = await fetch('/v1/domains/Condition/statistics');

​
Comprehensive Analysis

Get detailed analysis with all optional components: 
const detailedStats = await fetch('/v1/domains/Drug/statistics?include_growth_trends=true&include_usage_analytics=true&include_relationship_analysis=true');

​
SNOMED-Only Analysis

Analyze domain statistics for SNOMED concepts only: 
const snomedStats = await fetch('/v1/domains/Condition/statistics?vocabulary_ids=SNOMED&standard_only=true');

​
Growth Trend Analysis

Focus on historical growth patterns: 
const growthStats = await fetch('/v1/domains/Procedure/statistics?include_growth_trends=true&time_period=10y');

​
Usage Pattern Analysis

Get usage analytics for optimization: 
const usageStats = await fetch('/v1/domains/Drug/statistics?include_usage_analytics=true');

​
Notes

  • Statistics are calculated from the most recent vocabulary release
  • Growth trends require historical data and may not be available for all domains
  • Usage analytics are based on aggregated, anonymized query patterns
  • Cross-vocabulary mapping statistics help identify integration opportunities
  • Relationship analysis reveals connectivity patterns within domains
  • Large domains may have longer calculation times for comprehensive statistics
  • Standard concept statistics are preferred for clinical applications
  • Time series data helps identify seasonal patterns and growth trajectories