List Vocabularies

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

import requests

response = requests.get(
    "https://api.omophub.com/v1/vocabularies",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]["vocabularies"]:
    print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")

import { OMOPHub } from '@omophub/omophub-node';

const client = new OMOPHub();
const { data } = await client.vocabularies.list();
data?.vocabularies.forEach(vocab => {
  console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});

curl -X GET "https://api.omophub.com/v1/vocabularies?include_stats=true&sort_by=name&sort_order=asc&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.omophub.com/v1/vocabularies",
    params={
        "include_stats": True,
        "sort_by": "name",
        "sort_order": "asc",
        "page_size": 50
    },
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

{
  "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
    }
  }
}

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

import requests

response = requests.get(
    "https://api.omophub.com/v1/vocabularies",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]["vocabularies"]:
    print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")

import { OMOPHub } from '@omophub/omophub-node';

const client = new OMOPHub();
const { data } = await client.vocabularies.list();
data?.vocabularies.forEach(vocab => {
  console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});

curl -X GET "https://api.omophub.com/v1/vocabularies?include_stats=true&sort_by=name&sort_order=asc&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.omophub.com/v1/vocabularies",
    params={
        "include_stats": True,
        "sort_by": "name",
        "sort_order": "asc",
        "page_size": 50
    },
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

{
  "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

integer

default:"1"

Page number for pagination (1-based).

integer

default:"20"

Number of vocabularies to return per page (max 1000).

boolean

default:"false"

Include concept count statistics for each vocabulary.

boolean

default:"false"

Include inactive or deprecated vocabularies in the results.

string

default:"name"

Sort field. Options: name, priority, updated

string

default:"asc"

Sort order. Options: asc, desc

string

Specific vocabulary release version (e.g., “2025.1”). Defaults to the latest available release.

Response

boolean

Indicates if the request was successful.

object

Response data container.

Show Data Object

array

Array of vocabulary objects.

Show Vocabulary Object

string

Unique identifier for the vocabulary (e.g., “SNOMED”, “ICD10CM”).

string

Full name of the vocabulary.

string

Reference or source organization for the vocabulary.

string

Version identifier of the vocabulary.

integer

OMOP concept ID representing this vocabulary.

object

Response metadata and pagination information.

Show Metadata Object

string

Unique identifier for this request.

string

Vocabulary release version used.

string

Response timestamp (ISO format).

object

integer

Current page number.

integer

Items per page.

integer

Total vocabularies available.

integer

Total number of pages.

boolean

Whether next page exists.

boolean

Whether previous page exists.

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

import requests

response = requests.get(
    "https://api.omophub.com/v1/vocabularies",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()
for vocab in data["data"]["vocabularies"]:
    print(f"{vocab['vocabulary_id']}: {vocab['vocabulary_name']}")

import { OMOPHub } from '@omophub/omophub-node';

const client = new OMOPHub();
const { data } = await client.vocabularies.list();
data?.vocabularies.forEach(vocab => {
  console.log(`${vocab.vocabulary_id}: ${vocab.vocabulary_name}`);
});

curl -X GET "https://api.omophub.com/v1/vocabularies?include_stats=true&sort_by=name&sort_order=asc&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.omophub.com/v1/vocabularies",
    params={
        "include_stats": True,
        "sort_by": "name",
        "sort_order": "asc",
        "page_size": 50
    },
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

{
  "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

Get Vocabulary - Get details for a specific vocabulary
Search Vocabularies - Search vocabularies by name
Get Vocabulary Concepts - Get concepts within a vocabulary

API Reference

Search

Concepts

Concept Hierarchy

Mappings

FHIR Resolver

Relationships

Domains & Classifications

Vocabularies

Query Parameters

Response

Usage Examples

Basic List

With Statistics

Sorted by Name

Include Inactive

​Query Parameters

​Response

​Usage Examples

​Basic List

​With Statistics

​Sorted by Name

​Include Inactive

​Related Endpoints

Query Parameters

Response

Usage Examples

Basic List

With Statistics

Sorted by Name

Include Inactive

Related Endpoints