Biomarker Tools
Search lab results, look up LOINC codes, get biological age.
searchBiomarkers
Searches and filters the user's biomarker lab results. Returns values with reference ranges and categories. Only approved lab results are visible — uploaded results in PROCESSED status do not appear here until approved.
| Parameter | Notes |
|---|---|
biomarkerExternalId | Filter by specific biomarker ID |
biomarkerLoincCode | Filter by LOINC code (use getLoincCodes to find) |
searchParam | Free-text across names |
name | Exact name filter |
startDate / endDate | ISO-8601 (e.g. "2026-01-01" or "2026-01-01T00:00:00Z") |
categories | Comma-separated (e.g. "METABOLIC,HORMONAL") |
range | OPTIMAL | AVERAGE | OUT_OF_RANGE | UNKNOWN |
Returns: JSON with biomarker values, reference ranges, categories.
getLoincCodes
Returns all LOINC codes — standardized biomarker identifiers with names and descriptions. Use this to look up valid codes before filtering with searchBiomarkers.
Parameters: none
Returns: JSON list of LOINC codes with names and descriptions.
getBiologicalAge
Returns biological age history — a series of assessments showing how the user's biological age compares to calendar age, with the contributing biomarker values for each assessment.
Parameters: none
Returns: JSON list with currentAge, biologicalAge, source, measurementDate, and contributing biomarker values per assessment.
Empty results
If searchBiomarkers returns nothing, the user has no approved lab results. Check getUserLabRecords for any in PROCESSED status awaiting approval.