Getting Started

Quickstart

Fetch your first evidence assertion in under five minutes.

Install the SDK

Add the OpenBio SDK to your project.

bash

npm install @openbio/sdk

Authenticate

Create a client with your API key.

typescript

import { OpenBio } from '@openbio/sdk';

const client = new OpenBio({
  apiKey: process.env.OPENBIO_API_KEY,
});

Fetch a subject

Retrieve any biological subject by ID.

typescript

const james = await client.subjects.get('james-58');
// → {
//     id: 'james-58',
//     name: 'James',
//     age: 58,
//     subjectType: 'human',
//     evidenceCount: 847,
//     sourceSystems: ['Epic EHR', 'Quest Diagnostics', ...]
//   }

Query evidence

Retrieve typed evidence assertions with trust filtering.

typescript

const labs = await client.evidence.bySubject({
  subjectId: 'james-58',
  type: 'lab_result',
  trustLayer: ['source_fact', 'normalized_fact'],
});
// → EvidenceAssertion[] each with value, unit,
//   trustLayer, confidence, and full provenance

This SDK is in preview.

Try every call live in the API Playground, or explore the full API reference.

API Playground API Reference