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

{
  "success": true,
  "data": {
    "vocabularies": [
      {
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "vocabulary_reference": "SNOMED CT",
        "vocabulary_version": "US Edition 20240301",
        "vocabulary_concept_id": 45756746
      },
      {
        "vocabulary_id": "ICD10CM",
        "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
        "vocabulary_reference": "CMS",
        "vocabulary_version": "2024",
        "vocabulary_concept_id": 45756681
      },
      {
        "vocabulary_id": "LOINC",
        "vocabulary_name": "Logical Observation Identifiers Names and Codes",
        "vocabulary_reference": "Regenstrief Institute",
        "vocabulary_version": "2.76",
        "vocabulary_concept_id": 45756747
      },
      {
        "vocabulary_id": "RxNorm",
        "vocabulary_name": "RxNorm",
        "vocabulary_reference": "National Library of Medicine",
        "vocabulary_version": "2024-03-04",
        "vocabulary_concept_id": 45756748
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 25,
      "total_pages": 2,
      "has_next": true,
      "has_previous": false
    }
  }
}
This endpoint returns a paginated list of all available medical vocabularies in the system, including SNOMED CT, ICD-10-CM, LOINC, RxNorm, and others.

​
Query Parameters

​
page
integer
default:"1"
Page number for pagination (1-based).
​
page_size
integer
default:"20"
Number of vocabularies to return per page (max 1000).
​
include_stats
boolean
default:"false"
Include concept count statistics for each vocabulary.
​
include_inactive
boolean
default:"false"
Include inactive or deprecated vocabularies in the results.
​
sort_by
string
default:"name"
Sort field. Options: name, priority, updated
​
sort_order
string
default:"asc"
Sort order. Options: asc, desc
​
vocab_release
string
Specific vocabulary release version (e.g., “2025.1”). Defaults to the latest available release.

​
Response

​
success
boolean
Indicates if the request was successful.
​
data
object
Response data container.
​
meta
object
Response metadata and pagination information.
curl -X GET "https://api.omophub.com/v1/vocabularies" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "vocabularies": [
      {
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "vocabulary_reference": "SNOMED CT",
        "vocabulary_version": "US Edition 20240301",
        "vocabulary_concept_id": 45756746
      },
      {
        "vocabulary_id": "ICD10CM",
        "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
        "vocabulary_reference": "CMS",
        "vocabulary_version": "2024",
        "vocabulary_concept_id": 45756681
      },
      {
        "vocabulary_id": "LOINC",
        "vocabulary_name": "Logical Observation Identifiers Names and Codes",
        "vocabulary_reference": "Regenstrief Institute",
        "vocabulary_version": "2.76",
        "vocabulary_concept_id": 45756747
      },
      {
        "vocabulary_id": "RxNorm",
        "vocabulary_name": "RxNorm",
        "vocabulary_reference": "National Library of Medicine",
        "vocabulary_version": "2024-03-04",
        "vocabulary_concept_id": 45756748
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "vocab_release": "2025.1",
    "timestamp": "2025-01-05T10:00:00Z",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 25,
      "total_pages": 2,
      "has_next": true,
      "has_previous": false
    }
  }
}

​
Usage Examples

​
Basic List

Get all vocabularies with default pagination: 
GET /v1/vocabularies

​
With Statistics

Include concept counts for each vocabulary: 
GET /v1/vocabularies?include_stats=true

​
Sorted by Name

Get vocabularies sorted alphabetically: 
GET /v1/vocabularies?sort_by=name&sort_order=asc

​
Include Inactive

Include deprecated vocabularies: 
GET /v1/vocabularies?include_inactive=true