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
string
required
The unique identifier for the vocabulary (e.g., “SNOMED”, “ICD10CM”, “LOINC”).
Query Parameters
string
Specific vocabulary release version to query
Example:
Example:
2025.1Response
boolean
Indicates if the request was successful.
object
Show Statistics Object
Show Statistics Object
string
The vocabulary identifier.
string
Full vocabulary name.
integer
Total number of concepts in the vocabulary.
integer
Number of standard concepts (standard_concept = ‘S’).
integer
Number of classification concepts (standard_concept = ‘C’).
integer
Number of invalid/deprecated concepts.
integer
Number of currently active concepts.
string
Earliest valid start date among concepts.
string
Latest valid end date among concepts.
string
Timestamp of when statistics were last updated.
object
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