curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/stats" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/SNOMED/stats",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
print(f"Total concepts: {data['data']['total_concepts']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data } = await client.vocabularies.stats('SNOMED');
console.log(`Total concepts: ${data?.total_concepts}`);
{
"success": true,
"data": {
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"total_concepts": 354652,
"standard_concepts": 298456,
"classification_concepts": 56196,
"invalid_concepts": 12543,
"active_concepts": 342109,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31",
"last_updated": "2025-01-05T10:30:00Z",
"domain_distribution": [
{
"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
}
]
},
"meta": {
"request_id": "req_abc123def456",
"timestamp": "2025-01-05T10:30:00Z",
"vocab_release": "2025.1"
}
}
{
"success": false,
"error": {
"code": "VOCABULARY_NOT_FOUND",
"message": "Vocabulary 'INVALID_VOCAB' not found"
},
"meta": {
"request_id": "req_error123",
"timestamp": "2025-01-05T10:30:00Z"
}
}
Get Vocabulary Statistics
Retrieve comprehensive statistics for a specific OMOP vocabulary including concept counts, standard concept coverage, and domain distribution breakdown.
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/stats" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/SNOMED/stats",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
print(f"Total concepts: {data['data']['total_concepts']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data } = await client.vocabularies.stats('SNOMED');
console.log(`Total concepts: ${data?.total_concepts}`);
{
"success": true,
"data": {
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"total_concepts": 354652,
"standard_concepts": 298456,
"classification_concepts": 56196,
"invalid_concepts": 12543,
"active_concepts": 342109,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31",
"last_updated": "2025-01-05T10:30:00Z",
"domain_distribution": [
{
"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
}
]
},
"meta": {
"request_id": "req_abc123def456",
"timestamp": "2025-01-05T10:30:00Z",
"vocab_release": "2025.1"
}
}
{
"success": false,
"error": {
"code": "VOCABULARY_NOT_FOUND",
"message": "Vocabulary 'INVALID_VOCAB' not found"
},
"meta": {
"request_id": "req_error123",
"timestamp": "2025-01-05T10:30:00Z"
}
}
Retrieve detailed statistical information about a vocabulary, including the total number of concepts, breakdown by standard/classification status, and domain distribution.
Path Parameters
The unique identifier for the vocabulary (e.g., “SNOMED”, “ICD10CM”, “LOINC”).
Query Parameters
Specific vocabulary release version to query
Example:
Example:
2025.1Response
Indicates if the request was successful.
Show Statistics Object
Show Statistics Object
The vocabulary identifier.
Full vocabulary name.
Total number of concepts in the vocabulary.
Number of standard concepts (standard_concept = ‘S’).
Number of classification concepts (standard_concept = ‘C’).
Number of invalid/deprecated concepts.
Number of currently active concepts.
Earliest valid start date among concepts.
Latest valid end date among concepts.
Timestamp of when statistics were last updated.
curl -X GET "https://api.omophub.com/v1/vocabularies/SNOMED/stats" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.get(
"https://api.omophub.com/v1/vocabularies/SNOMED/stats",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
print(f"Total concepts: {data['data']['total_concepts']}")
import { OMOPHub } from '@omophub/omophub-node';
const client = new OMOPHub();
const { data } = await client.vocabularies.stats('SNOMED');
console.log(`Total concepts: ${data?.total_concepts}`);
{
"success": true,
"data": {
"vocabulary_id": "SNOMED",
"vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
"total_concepts": 354652,
"standard_concepts": 298456,
"classification_concepts": 56196,
"invalid_concepts": 12543,
"active_concepts": 342109,
"valid_start_date": "2002-01-31",
"valid_end_date": "2099-12-31",
"last_updated": "2025-01-05T10:30:00Z",
"domain_distribution": [
{
"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
}
]
},
"meta": {
"request_id": "req_abc123def456",
"timestamp": "2025-01-05T10:30:00Z",
"vocab_release": "2025.1"
}
}
{
"success": false,
"error": {
"code": "VOCABULARY_NOT_FOUND",
"message": "Vocabulary 'INVALID_VOCAB' not found"
},
"meta": {
"request_id": "req_error123",
"timestamp": "2025-01-05T10:30:00Z"
}
}
Usage Examples
Get Statistics for SNOMED
GET /v1/vocabularies/SNOMED/stats
Get Statistics for ICD-10-CM
GET /v1/vocabularies/ICD10CM/stats
Get Statistics for a Specific Release
GET /v1/vocabularies/SNOMED/stats?vocab_release=2025.1
Related Endpoints
- List Vocabularies - Get all available vocabularies
- Get Vocabulary Details - Get detailed vocabulary information
- Get Vocabulary Concepts - Get concepts within a vocabulary
Was this page helpful?
⌘I