Skip to main content
curl -X GET "https://api.omophub.com/v1/vocabularies" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "vocabulary_reference": "SNOMED CT",
      "vocabulary_version": "US Edition 20240301",
      "vocabulary_concept": 45756746,
      "description": "Comprehensive clinical healthcare terminology",
      "priority": 1,
      "is_active": true,
      "last_updated": "2024-03-01T00:00:00Z",
      "concept_count": 354321,
      "domains": ["Condition", "Procedure", "Drug", "Observation"]
    },
    {
      "vocabulary_id": "ICD10CM",
      "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
      "vocabulary_reference": "CMS",
      "vocabulary_version": "2024",
      "vocabulary_concept": 45756681,
      "description": "Standard diagnostic coding system for clinical and administrative use",
      "priority": 2,
      "is_active": true,
      "last_updated": "2024-01-01T00:00:00Z",
      "concept_count": 72967,
      "domains": ["Condition"]
    },
    {
      "vocabulary_id": "LOINC",
      "vocabulary_name": "Logical Observation Identifiers Names and Codes",
      "vocabulary_reference": "Regenstrief Institute",
      "vocabulary_version": "2.76",
      "vocabulary_concept": 45756747,
      "description": "Universal standard for identifying medical laboratory observations",
      "priority": 3,
      "is_active": true,
      "last_updated": "2024-02-15T00:00:00Z",
      "concept_count": 96952,
      "domains": ["Measurement", "Observation"]
    },
    {
      "vocabulary_id": "RxNorm",
      "vocabulary_name": "RxNorm",
      "vocabulary_reference": "National Library of Medicine",
      "vocabulary_version": "2024-03-04",
      "vocabulary_concept": 45756748,
      "description": "Standardized nomenclature for clinical drugs",
      "priority": 4,
      "is_active": true,
      "last_updated": "2024-03-04T00:00:00Z",
      "concept_count": 148796,
      "domains": ["Drug"]
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 25,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "request_id": "req_vocab_list_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

This endpoint returns a list of all available medical vocabularies in the system. You can optionally include statistics such as concept counts and filter for active or inactive vocabularies.

​
Features

  • Comprehensive Listing: Get all available vocabularies (SNOMED CT, ICD-10-CM, LOINC, RxNorm, etc.)
  • Optional Statistics: Include concept counts and metadata
  • Filtering: Show only active vocabularies or include inactive ones
  • Sorting: Sort by name, priority, or last updated date
  • Pagination: Handle large vocabulary lists efficiently

​
Query Parameters

​
includeStats
boolean
default:"false"
Include concept count statistics for each vocabulary
​
includeInactive
boolean
default:"false"
Include inactive or deprecated vocabularies in the results
​
sortBy
string
default:"priority"
Sort field. Options: name, priority, updated
​
sortOrder
string
default:"asc"
Sort order. Options: asc, desc
​
limit
integer
default:"50"
Maximum number of vocabularies to return (max: 1000)
​
offset
integer
default:"0"
Number of vocabularies to skip for pagination
curl -X GET "https://api.omophub.com/v1/vocabularies" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "vocabulary_id": "SNOMED",
      "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
      "vocabulary_reference": "SNOMED CT",
      "vocabulary_version": "US Edition 20240301",
      "vocabulary_concept": 45756746,
      "description": "Comprehensive clinical healthcare terminology",
      "priority": 1,
      "is_active": true,
      "last_updated": "2024-03-01T00:00:00Z",
      "concept_count": 354321,
      "domains": ["Condition", "Procedure", "Drug", "Observation"]
    },
    {
      "vocabulary_id": "ICD10CM",
      "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
      "vocabulary_reference": "CMS",
      "vocabulary_version": "2024",
      "vocabulary_concept": 45756681,
      "description": "Standard diagnostic coding system for clinical and administrative use",
      "priority": 2,
      "is_active": true,
      "last_updated": "2024-01-01T00:00:00Z",
      "concept_count": 72967,
      "domains": ["Condition"]
    },
    {
      "vocabulary_id": "LOINC",
      "vocabulary_name": "Logical Observation Identifiers Names and Codes",
      "vocabulary_reference": "Regenstrief Institute",
      "vocabulary_version": "2.76",
      "vocabulary_concept": 45756747,
      "description": "Universal standard for identifying medical laboratory observations",
      "priority": 3,
      "is_active": true,
      "last_updated": "2024-02-15T00:00:00Z",
      "concept_count": 96952,
      "domains": ["Measurement", "Observation"]
    },
    {
      "vocabulary_id": "RxNorm",
      "vocabulary_name": "RxNorm",
      "vocabulary_reference": "National Library of Medicine",
      "vocabulary_version": "2024-03-04",
      "vocabulary_concept": 45756748,
      "description": "Standardized nomenclature for clinical drugs",
      "priority": 4,
      "is_active": true,
      "last_updated": "2024-03-04T00:00:00Z",
      "concept_count": 148796,
      "domains": ["Drug"]
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total_items": 25,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "request_id": "req_vocab_list_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

​
Common Use Cases

​
1. Healthcare Application Setup

Get available vocabularies to populate dropdown menus in clinical applications.

​
2. Data Analysis Planning

Check concept counts and domains to plan analysis scope.

​
3. Vocabulary Version Management

Monitor vocabulary versions and updates for compliance tracking.

​
4. System Integration

Discover available terminologies for mapping and integration projects.

​
Best Practices

  1. Cache Results: Vocabulary lists change infrequently, cache responses for 1+ hours
  2. Use Pagination: For applications with many vocabularies, implement pagination
  3. Filter Appropriately: Use includeInactive=false unless specifically needed
  4. Monitor Updates: Check last_updated timestamps to detect vocabulary updates
  5. Sort by Priority: Use priority sorting to display most important vocabularies first
⌘I