Overview
This endpoint provides detailed statistical information about a vocabulary, including the total number of concepts, breakdown by domains and concept classes, and relationship statistics.
Path Parameters
The unique identifier for the vocabulary (e.g., “SNOMED”, “ICD10CM”, “LOINC”)
Query Parameters
Include detailed breakdown statistics by domain and concept class
Specific vocabulary release version (defaults to latest)
Response
Indicates if the request was successful
The vocabulary identifier
Total number of concepts in the vocabulary
Number of standard concepts
Number of classification concepts
Array of domain statistics Number of concepts in this domain
Array of concept class statistics Number of concepts in this class
Total number of relationships
Release date of the vocabulary version
Unique identifier for the request
Vocabulary release version used
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/stats?include_details=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" ,
"total_concepts" : 354652 ,
"standard_concepts" : 298456 ,
"classification_concepts" : 56196 ,
"domains" : [
{
"domain_id" : "Condition" ,
"domain_name" : "Condition" ,
"concept_count" : 112543
},
{
"domain_id" : "Procedure" ,
"domain_name" : "Procedure" ,
"concept_count" : 87321
},
{
"domain_id" : "Observation" ,
"domain_name" : "Observation" ,
"concept_count" : 65432
}
],
"concept_classes" : [
{
"concept_class_id" : "Clinical Finding" ,
"concept_class_name" : "Clinical Finding" ,
"concept_count" : 98765
},
{
"concept_class_id" : "Procedure" ,
"concept_class_name" : "Procedure" ,
"concept_count" : 76543
}
],
"relationships_count" : 1234567 ,
"release_date" : "2024-03-01"
},
"meta" : {
"request_id" : "req_abc123def456" ,
"timestamp" : "2024-01-15T10:30:00Z" ,
"vocab_release" : "2025.2"
}
}
Usage Examples
Basic Statistics
Get basic statistics for SNOMED vocabulary:
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/stats" \
-H "Authorization: Bearer YOUR_API_KEY"
Detailed Statistics
Get detailed statistics including domain and class breakdowns:
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/stats?include_details=true" \
-H "Authorization: Bearer YOUR_API_KEY"
Specific Release Version
Get statistics for a specific vocabulary release:
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/stats?vocab_release=2024-01" \
-H "Authorization: Bearer YOUR_API_KEY"