Biomarkers | Sahha Docs

Biomarkers Hero

Dashboards ·Challenges ·Analytics/BI ·Monitoring

Introduction

Clean, standardized health metrics from any source. Sahha collects raw data from smartphones and wearables, deduplicates it, and outputs 60+ biomarkers across sleep, activity, vitals, body composition, and engagement.

Key Features

Real-time

Updates within 1 minute—always current data for your users

Deduplicated

Multiple sources merged intelligently—no double-counting steps

Standardized

Consistent units and formats across all devices and platforms

Comprehensive

60+ metrics across sleep, activity, vitals, body, and engagement

Derived Metrics

Proprietary biomarkers like sleep debt and activity regularity

Flexible Access

Query via API on-demand or stream via webhooks in real-time

How It Works

Raw health data flows in from HealthKit, Health Connect, and wearables. Sahha cleans, deduplicates, and normalizes this data into standardized biomarkers—each with consistent units, aggregation methods, and update frequencies.

The pipeline:

Collect — Raw samples from multiple sources
Deduplicate — Remove overlapping records
Aggregate — Daily totals, averages, or point-in-time values
Deliver — Via API or webhooks in real-time

List of Biomarkers

Activity

Body

Sleep

Vitals

Engagement

Reproductive (Coming 2026)

Browse our comprehensive data dictionary to view all available outputs beyond just biomarkers.

Output Schema

Every biomarker returns a consistent JSON structure with the value, unit, and time range.

id UUID

Idempotent identifier—updates replace the previous entry with the same id

type string

Biomarker type (e.g., steps, heart_rate_resting, sleep_duration)

category string

Category: activity, body, sleep, vitals, engagement

value string

The measured or aggregated value

valueType string

Data type of the value: long, double, string, datetime

unit string

Unit of measurement (e.g., count, minute, bpm, percentage)

aggregation string

How the value was derived: total, average, minimum, maximum, none

periodicity string

Update frequency: daily, weekly, monthly, none

startDateTime datetime

Start of the measurement period (ISO 8601)

endDateTime datetime

End of the measurement period (ISO 8601)

createdAtUtc datetime

UTC timestamp when the entry was created

Example Response

json

{
	"id": "b7c8d9e0-f1a2-3456-bcde-f78901234567",
	"type": "steps",
	"category": "activity",
	"value": "8432",
	"valueType": "long",
	"unit": "count",
	"aggregation": "total",
	"periodicity": "daily",
	"startDateTime": "2024-09-03T00:00:00+05:00",
	"endDateTime": "2024-09-03T23:59:59+05:00",
	"createdAtUtc": "2024-09-04T05:30:00Z"
}

FAQ

How frequently are biomarkers updated?

Biomarkers are updated based on their periodicity settings, which can be daily, weekly, or intraday.

Are wearable devices required to capture all biomarkers?

While some biomarkers require wearable devices, others can be derived from different health data sources.

Getting Started

API

Query biomarkers on-demand by category or type

Webhooks

Receive biomarkers automatically as they're calculated

Widgets

Display biomarkers with pre-built UI components

Support

For additional assistance or more detailed information on biomarkers, please contact support@sahha.ai or reach out in the slack community .