---
title: Biomarkers
subtitle: Standardized metrics that track physiology and state
---


![Biomarkers Hero](/images/products/biomarkers/biomarkers-hero.webp)

{% use-cases items="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.

{% callout title="Related Products" %}
Want patterns over time? See [Insights](/docs/products/insights). Need raw sample data? See [Get Samples](/docs/connect/sdk/data/samples).
{% /callout %}

---

## Key Features

{% cards smCols=2 %}

{% card title="Real-time" description="Updates within 1 minute—always current data for your users" /%}
{% card title="Deduplicated" description="Multiple sources merged intelligently—no double-counting steps" /%}
{% card title="Standardized" description="Consistent units and formats across all devices and platforms" /%}
{% card title="Comprehensive" description="60+ metrics across sleep, activity, vitals, body, and engagement" /%}
{% card title="Derived Metrics" description="Proprietary biomarkers like sleep debt and activity regularity" /%}
{% card title="Flexible Access" description="Query via API on-demand or stream via webhooks in real-time" /%}

{% /cards %}

---

## 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:**

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

---

## List of Biomarkers

### Activity

{% metric-list category="activity" /%}

### Body

{% metric-list category="body" /%}

### Sleep

{% metric-list category="sleep" /%}

### Vitals

{% metric-list category="vitals" /%}

### Engagement

{% metric-list category="engagement" /%}

### Reproductive (Coming 2026)

{% metric-list category="reproductive" /%}

Browse our [comprehensive data dictionary](/docs/get-started/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.

{% api-example %}

{% api-panel %}
{% api-property field="id" type="UUID" description="Idempotent identifier—updates replace the previous entry with the same id" /%}
{% api-property field="type" type="string" description="Biomarker type (e.g., steps, heart_rate_resting, sleep_duration)" /%}
{% api-property field="category" type="string" description="Category: activity, body, sleep, vitals, engagement" /%}
{% api-property field="value" type="string" description="The measured or aggregated value" /%}
{% api-property field="valueType" type="string" description="Data type of the value: long, double, string, datetime" /%}
{% api-property field="unit" type="string" description="Unit of measurement (e.g., count, minute, bpm, percentage)" /%}
{% api-property field="aggregation" type="string" description="How the value was derived: total, average, minimum, maximum, none" /%}
{% api-property field="periodicity" type="string" description="Update frequency: daily, weekly, monthly, none" /%}
{% api-property field="startDateTime" type="datetime" description="Start of the measurement period (ISO 8601)" /%}
{% api-property field="endDateTime" type="datetime" description="End of the measurement period (ISO 8601)" /%}
{% api-property field="createdAtUtc" type="datetime" description="UTC timestamp when the entry was created" /%}
{% /api-panel %}

```json {% title="Example Response" %}
{
	"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"
}
```

{% /api-example %}

---

<!-- ## Use Cases
For Individuals
- Monitor and understand personal health trends.
- Make lifestyle changes based on biomarker insights.
For Healthcare Providers
- Utilize biomarker data for comprehensive patient assessments.
- Tailor health interventions based on biomarker profiles.

--- -->

## FAQ

{% faq %}

{% faq-item question="How frequently are biomarkers updated?" %}
Biomarkers are updated based on their periodicity settings, which can be daily, weekly, or intraday.
{% /faq-item %}

{% faq-item question="Are wearable devices required to capture all biomarkers?" %}
While some biomarkers require wearable devices, others can be derived from different health data sources.
{% /faq-item %}

{% /faq %}

---

## Getting Started

{% action-cards %}

{% action-card icon="code" href="/docs/connect/api" title="API" description="Query biomarkers on-demand by category or type" /%}

{% action-card icon="bell" href="/docs/connect/webhooks" title="Webhooks" description="Receive biomarkers automatically as they're calculated" /%}

{% action-card icon="squares-four" href="/docs/products/widgets" title="Widgets" description="Display biomarkers with pre-built UI components" /%}

{% /action-cards %}

---

## Support

For additional assistance or more detailed information on biomarkers, please contact [support@sahha.ai](mailto:support@sahha.ai) or reach out in the [slack community](https://join.slack.com/t/sahhacommunity/shared_invite/zt-1w0fmfbvk-qUwQ83tJgXyjT9XSxJvKIw).