BloomDocs
Dashboard

Lab tests

Your records are private, secure and always available when you need them. Our team has done this many times, so you never have to guess.

7 min read Updated Sep 24, 2025 v4.1.12

Overview

We measure success by how many patients come back and tell their friends. We work with most insurance providers and explain any costs upfront. Children are welcome, and our paediatric team knows how to make them smile. Our specialists take time to listen and explain every step of your treatment.

Same-day appointmentsVideo consultations let you speak with a doctor from the comfort of home.Certified specialistsWe listen first, then build a plan around what you actually need.Online resultsClear prices, honest advice and no surprises along the way.

Installation

Install the SDK with the package manager your project already uses. It needs Node 18 or newer.

terminal
$ npm install @bloom/sdk
terminal
$ yarn add @bloom/sdk
terminal
$ pnpm add @bloom/sdk
Using a server without Node? The same endpoints are available over plain HTTPS; see the API reference below.

Configuration

Thousands of patients already trust us, and we work hard to keep it that way. Family plans cover check-ups and vaccinations for everyone under one roof. Create a file named bloom.config.json in the project root:

bloom.config.json
{
  "project": "bloom",
  "region": "us-east",
  "categories": ["cardiology", "dental", "pediatrics"],
  "retries": 4,
  "timeoutMs": 10000,
  "webhooks": { "enabled": true }
}
OptionTypeDefaultDescription
projectstring-Your project key from the dashboard.
regionstring"us-east"Data centre closest to your patients.
retriesnumber3How often a failed call is retried.
timeoutMsnumber10000Time before a request is cancelled.
webhooks.enabledbooleanfalseSend events to your endpoint.

Your first request

Friendly reminders make sure you never miss a check-up or a dose.

  1. Create an API keyOpen the dashboard, choose Settings › API keys and copy a new secret key.
  2. Store it safelyKeep the key in an environment variable, never in your source code.
  3. Make the callRun the snippet below; it prints the first page of results.
index.js
import { Client } from "@bloom/sdk";

const client = new Client({ apiKey: process.env.API_KEY });

// list the newest services in one category
const page = await client.services.list({ category: "cardiology", limit: 20 });

for (const item of page.data) {
  console.log(item.name, item.price);
}
Heads up: test keys only return sample data. Switch to a live key before you go to production.

API reference

Every endpoint returns JSON and uses standard HTTP status codes.

GET/v1/servicesList services with paging and filters.
POST/v1/servicesCreate a new service.
PATCH/v1/services/{id}Update some fields of a service.
DELETE/v1/services/{id}Archive a service; it can be restored for 30 days.
response.json
{
  "data": [
    { "id": "service_3303", "name": "Dental cleaning", "price": 350 }
  ],
  "has_more": true
}

Troubleshooting

Lab results arrive in your patient portal, usually within 48 hours. We keep things simple, so you can focus on what matters to you.

Friendly people answer your questions quickly, by phone, chat or email. Start in minutes and get help from a real person whenever you need it.

Friendly reminders make sure you never miss a check-up or a dose. Children are welcome, and our paediatric team knows how to make them smile.

Next steps

We measure success by how many patients come back and tell their friends.

Was this page helpful?
All screens