Skip to main content
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"
I