Skip to main content
GET
https://api.omophub.com
/
v1
/
vocabularies
/
:vocabularyId
/
stats
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"
  }
}

​
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

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

​
Query Parameters

​
include_details
boolean
default:"false"
Include detailed breakdown statistics by domain and concept class
​
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/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"