Betterness
How it worksBett-iTutorialsAboutFor businesses ↗, opens Betterness One in a new tabLog inSign up
How it worksBett-iTutorialsAboutFor businesses: Betterness One ↗, opens Betterness One in a new tab
Log inSign up
Skip to content

Overview

  • What is Betterness

Connect

  • Connect by signing in
  • Claude custom connector
  • ChatGPT custom MCP server
  • Permissions
  • Connected apps
  • Privacy and data

Trust

  • Trust Center
  • Audit Trail
  • Limits & Scopes

Resources

  • Troubleshooting
  • Glossary

Server

Get started

  • Connect with an API Key
  • Authentication
  • First Tool Call

Clients

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • ChatGPT
  • OpenClaw / BetterClaw

Recipes

  • Health Overview
  • Order Labs
  • Upload Lab Results
  • Biomarker Gap Analysis
  • Connect Wearables
  • Health Profile

Tools

  • All Tools
  • Profile
  • Wearables
  • Health Data
  • Nutrition
  • Logging
  • Biomarkers
  • Documents
  • Lab Tests
  • Lab Records
  • Lab Orders
  • Lab Results
  • Purchases
  • Confirming Actions
  • Inbox
  • Training Program
  • Updates
  • Health Profile
Docs/Betterness/Tools/Lab Orders

Lab Order Tools

Lifecycle: send to the lab, find a center, book, reschedule, cancel. Changes wait for confirm_action.


initializeLabOrder

Prepares sending a "Paid" order to the lab. Nothing is sent: it returns a preview (the test and the personal details the lab receives: name, birth date, gender, phone, home address) and a pendingId. Only after the user approves, confirm_action(pendingId) sends it, once. Profile must have gender, phone (with dial code), birth date, and complete home address; otherwise the preview names what is missing. At-home phlebotomy orders are finished in the Betterness app.

ParameterRequired
labOrderExternalIdyes

Before calling: getProfile() to verify required fields. Use updateProfile to fix anything missing.

searchLabServiceCenters

Patient Service Centers near a ZIP, sorted by distance. Use after order reaches "Requisition Created".

ParameterRequiredNotes
zipCodeyes—
labOrderExternalIdyesDetermines which lab network to search
limitnoDefault 6
offsetnoPagination, default 0

Returns: centers array (each with siteCode, name, phone, address, distanceMiles, hours) plus pagination fields.

getServiceCenterSlots

Available appointment time slots at a center. Ask the user for date / time preference first so you can set startDate and rangeDays.

ParameterRequired
siteCodeyes (from searchLabServiceCenters)
labOrderExternalIdyes
timezoneyes (IANA, e.g. America/New_York)
startDateno, defaults to today
rangeDaysno, default 7

Always present slots and let the user choose. Don't pick automatically. If no slots are available, offer to search later dates by calling again with a later startDate.

bookLabAppointment

Prepares booking an appointment with a bookingKey from getServiceCenterSlots (valid for 30 minutes). Nothing is booked: returns a preview (test, date, time, place) and a pendingId. After the user approves it, confirm_action books it. Order must be in "Requisition Created" or "Appointment Cancelled" status.

Use this (not rescheduleLabAppointment) to book after a cancellation.

ParameterRequired
labOrderExternalIdyes
bookingKeyyes
timezoneyes

Permission: labs:order

rescheduleLabAppointment

Prepares moving an appointment to another slot. Nothing changes: returns a preview (the current and the new appointment) and a pendingId for confirm_action. Only works when the order is in "Appointment Scheduled" status. The previous appointment is cancelled when the new one is booked.

If already cancelled, use bookLabAppointment instead.

ParameterRequired
labOrderExternalIdyes
bookingKeyyes (new slot)
timezoneyes

cancelLabAppointment

First call without reasonId to get the cancellation reasons. Call again with the reason the user chose: that returns a preview and a pendingId. Nothing is cancelled until confirm_action.

ParameterRequiredNotes
labOrderExternalIdyes—
reasonIdnoOmit to get reasons; pass it to get the preview
PreviousLab RecordsNextLab Results
Betterness

Product

  • How it works
  • Bett-i
  • Connect your AI

Resources

  • Tutorials
  • Podcast

Company

  • About
  • News
  • Contact

Legal

  • Privacy
  • Terms
  • Health data
  • Delete your account

For businesses

  • Betterness One ↗, opens Betterness One in a new tab

News from Betterness: the Friday Letter, launches and stories, by email.

  • Instagram ↗, opens in a new tab
  • X ↗, opens in a new tab
  • YouTube ↗, opens in a new tab
  • LinkedIn ↗, opens in a new tab
Download on the App StoreGet it on Google Play
HIPAA, powered by Vanta

HIPAA compliance monitored by Vanta.

Betterness, Inc. · Betterness gives health information, not medical advice.