Search Biomarkers

Prerequisites

• You have at least one approved lab result (uploaded or via an order)

Search

betterness biomarkers search

Flag	Example
--name	--name "Vitamin D"
--loinc-code	--loinc-code 14635-7
--start-date	--start-date 2026-01-01
--end-date	--end-date 2026-03-31
--categories	--categories "METABOLIC,HORMONAL"
--range	--range OUT_OF_RANGE
--limit	--limit 50 (default 20)

Common queries

# Single biomarker
betterness biomarkers search --name "CRP"

# Everything out of range
betterness biomarkers search --range OUT_OF_RANGE --limit 50

# Hormones from this year
betterness biomarkers search --categories "HORMONAL" --start-date 2026-01-01

# Pipe into jq
betterness biomarkers search --json | jq '.[] | {name, value, range}'

LOINC codes

betterness biomarkers loinc-codes

All available LOINC codes with names. Use these to cross-reference with lab tests (lab-tests list --loinc-slug ...).

Biological age

betterness biological-age get

Biological age history — how the user's biological age compares to calendar age, with the contributing biomarker values for each assessment.

Tips

• Biomarkers only appear after lab results are approved. Empty results? Check lab-records list for PROCESSED records waiting on approval.
• Use --json for scripting and piping to jq.
• Range filter values: OPTIMAL, AVERAGE, OUT_OF_RANGE, UNKNOWN.