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 Records

Lab Records Tools

Unified view of orders and uploaded results.


getUserLabRecords

Returns lab orders and uploaded lab results in one unified format.

ParameterNotes
externalIdFilter to a specific order or result
startDateyyyy-MM-dd — only items collected on or after
endDateyyyy-MM-dd — only items collected on or before

Each item:

  • source — "order" (placed through Betterness) or "result" (uploaded)
  • externalId, name, status
  • statusDescription — what the status means (orders only)
  • nextStep — tells the agent exactly what to do next (orders only)
  • appointment — when status is "Appointment Pending" or "Appointment Scheduled" (orders only)
  • dateCollected, dateCreated

getLabRecordDetail

Full detail of one record. Auto-detects whether it's an order or an uploaded result.

ParameterRequired
recordExternalIdyes (from getUserLabRecords)

For uploaded results (source: "result"): externalId, status, filename, dateUploaded, patientInfo, testDetails, biomarkerCount, biomarkers array.

For lab orders (source: "order"): externalId, testName, testDescription, lab, status, statusDescription, nextStep, dateCollected, dateCreated, appointment (if any), biomarkerCount + biomarkers when results are available.

Always follow nextStep

Every order's nextStep field tells the agent the exact action to take based on current status. Use it as your primary guide rather than parsing status strings yourself.

PreviousLab TestsNextLab Orders
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.