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

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.

Show Data Object

vocabularies

array

Array of vocabulary objects.

Show Vocabulary Object

vocabulary_id

string

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

vocabulary_name

string

Full name of the vocabulary.

vocabulary_reference

string

Reference or source organization for the vocabulary.

vocabulary_version

string

Version identifier of the vocabulary.

vocabulary_concept_id

integer

OMOP concept ID representing this vocabulary.

meta

object

Response metadata and pagination information.

Show Metadata Object

request_id

string

Unique identifier for this request.

vocab_release

string

Vocabulary release version used.

timestamp

string

Response timestamp (ISO format).

pagination

object

page

integer

Current page number.

page_size

integer

Items per page.

total_items

integer

Total vocabularies available.

total_pages

integer

Total number of pages.

has_next

boolean

Whether next page exists.

has_previous

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

Get Concept Classes Get Vocabulary Details

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