Installation and Quickstart

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

const client = new OMOPHub('oh_xxxxxxxxx');

// Get a concept
const { data, error } = await client.concepts.get(201826);
if (error) throw new Error(error.message);
console.log(data.concept_name); // "Type 2 diabetes mellitus"

// Search concepts
const results = await client.search.basic('diabetes', { pageSize: 5 });
if (results.error) throw new Error(results.error.message);
for (const concept of results.data.concepts) {
  console.log(`${concept.concept_id}: ${concept.concept_name}`);
}

const { data, error } = await client.concepts.get(999_999_999);
if (error) {
  console.error(error.name, error.message, error.statusCode);
  return;
}
// `data` is now typed as Concept
console.log(data.concept_name);

const client = new OMOPHub('oh_xxx', {
  baseUrl: 'https://api.omophub.com/v1',
  timeoutMs: 30_000,
  maxRetries: 3,
  vocabVersion: '2025.1',
});

export OMOPHUB_API_KEY=oh_xxxxxxxxx

// API key is read from process.env.OMOPHUB_API_KEY
const client = new OMOPHub();