Comparisons | Sahha Docs

Introduction

Comparisons are part of Sahha Insights . They provide context to daily scores or biomarkers by comparing them with relevant reference groups, helping to understand if values are typical, high, or low compared to global averages, similar demographic cohorts, or personal historical baselines.

List of Comparisons

Name	Category	Description	Unit	isHigherBetter
wellbeing	score	Holistic health combining sleep and activity	`index`	`true`
activity	score	Physical activity and movement levels	`index`	`true`
sleep	score	Overall sleep quality	`index`	`true`
readiness	score	Body's recovery state and preparedness for exertion	`index`	`true`
mental_wellbeing	score	Mental wellbeing state based on behavioral patterns	`index`	`true`
steps	biomarker	Daily step count	`count`	`true`
sleep_duration	biomarker	Total time spent asleep	`minute`	`true`
heart_rate_resting	biomarker	Resting heart rate	`bpm`	`false`
heart_rate_variability_sdnn	biomarker	HRV measured as SDNN	`ms`	`true`
heart_rate_variability_rmssd	biomarker	HRV measured as RMSSD	`ms`	`true`
vo2_max	biomarker	Maximum oxygen uptake	`mL/kg/min`	`true`

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

How It Works

Comparisons provide three distinct reference points to contextualize metric values:

Global: Comparison against global population averages.
Demographic: Comparison against people with similar characteristics (e.g., age and gender).
Baseline: Comparison against an individual's historical average over the last 30 days.

Comparisons are calculated daily, and include:

The reference group's average value
Percentile position within the group (not applicable for baseline)
Absolute and percentage differences compared to the individual's value
A descriptive state label ( very_low, low, average, high, very_high) based on the percentile position

Output Schema

Each comparison is scoped to a single profile and metric, calculated daily, and provides a snapshot of the profile's values relative to the three comparison groups.

id UUID

Unique identifier for the comparison

type string

Always set to comparison

category string

One of score or biomarker

name string

Metric being compared (e.g., readiness)

value float nullable

Your value for this metric

unit string

Unit of the metric (e.g., index, bpm, count)

isHigherBetter boolean nullable

Whether higher values are better

periodicity string

Frequency of calculation (daily)

startDateTime datetime

Start of the daily window

endDateTime datetime

End of the daily window

data ComparisonData[]

List of comparisons (global, demographic, baseline)

createdAtUtc datetime

UTC timestamp when calculated

version float

Version of comparisons

Example Response

json

{
	"type": "comparison",
	"category": "score",
	"name": "readiness",
	"value": 0.75,
	"unit": "index",
	"isHigherBetter": true,
	"periodicity": "daily",
	"startDateTime": "2025-04-02T00:00:00+04:00",
	"endDateTime": "2025-04-02T23:59:59+04:00",
	"data": [
		{
			"type": "demographic",
			"value": 0.71,
			"percentile": 58,
			"state": "average",
			"properties": { "ageMin": 30, "ageMax": 44, "gender": "female" }
		},
		{ "type": "global", "value": 0.78, "percentile": 42, "state": "average" },
		{
			"type": "baseline",
			"value": 0.84,
			"percentile": null,
			"difference": -0.09,
			"properties": { "windowDays": 30 }
		}
	],
	"createdAtUtc": "2025-04-06T09:30:00Z"
}

Object

ComparisonData

Each entry in the data array contains:

type string

Comparison group: global, demographic, baseline

value float nullable

Reference group's average value

percentile integer nullable

Your percentile rank (null for baseline)

difference float nullable

Absolute difference from your value

percentageDifference float nullable

Relative percentage difference

state string

Comparison category: very_low, low, average, high, very_high

properties object nullable

Additional info (demographic details or baseline window)

Getting Started

API

Query comparisons via GET /api/v1/profile/insight/comparison

Webhooks Coming Soon

Receive daily comparison updates automatically

Support

For assistance with Comparisons or the Insights product, contact us at support@sahha.ai or join the Sahha Slack Community .