Scores | Sahha Docs

Q: What if data is missing?

Scores adapt. If a factor can't be calculated, it returns and the score adjusts. A minimum of 3 factors is needed.

Scores Hero

Engagement ·Coaching ·Challenges ·Product Recommendations

Introduction

Transform complex health data into simple 0-1 scores that your users actually understand. Each score comes with explainable factors, so users know exactly what to improve—and your product can deliver personalized experiences that drive engagement.

Available Scores

Score	Status	Description
Wellbeing	Live	Holistic health combining sleep, activity, and mental wellness
Activity	Live	Daily physical activity—steps, calories, active hours, intensity
Sleep	Live	Sleep quality—duration, regularity, stages, and recovery
Mental Wellbeing	Live	Mental wellness derived from sleep and activity patterns
Readiness	Live	Daily recovery and preparedness for physical exertion

Coming Soon

Score	Status	Description
Nutrition	Coming Soon	Food intake, glucose impact, and dietary patterns
Depression	Coming Soon	Behavioral similarity to depression patterns
Stress	Coming Soon	Chronic stress from lifestyle and physiological signals
Anxiety	Coming Soon	Behavioral similarity to anxiety patterns
Digital	Coming Soon	Screen time, app usage, and digital habit impact

Browse the data dictionary for all available outputs.

Key Features

Smartphone Compatible

Works with phones alone or wearables—reach 100% of your users without hardware requirements

Explainable

Every score shows contributing factors—users understand the 'why' behind their number

Real-time

Updates in under 1 minute—scores always reflect the user's current state

Instant Value

14 days of retroactive scores on integration—users see insights from day one

Actionable

Each factor includes goals—users know exactly what to improve

Research-backed

Built on peer-reviewed research and validated for clinical accuracy

How It Works

Health data flows in from smartphones and wearables. Sahha's models analyze this data and output a normalized 0-1 score with contributing factors. Higher scores indicate better health in that dimension.

Each score includes factors that break down exactly what's contributing to the result—like sleep duration, step count, or heart rate variability. Each factor shows the current value, the goal, and its own sub-score, so users understand what to improve.

Use Cases

Personalized Coaching

Adapt recommendations based on which factors need improvement

Gamification

Power challenges, streaks, and rewards tied to real health progress

Insurance Underwriting

Assess policyholder wellness for dynamic pricing and risk models

Employee Wellness

Track workforce health trends and measure program effectiveness

Clinical Monitoring

Remotely track patient wellness between appointments

User Engagement

Surface health insights that keep users coming back daily

Output Schema

Every score returns a consistent JSON structure with the score value, state, and contributing factors.

id UUID

Unique identifier for each score entry

profileId UUID

Unique identifier for the associated profile

accountId UUID

Unique identifier for the account linked to the profile

externalId UUID

External identifier associated with the profile

type string

Type of score: activity, sleep, readiness, wellbeing, mental_wellbeing

score float

Calculated score from 0.0 to 1.0 where 1.0 is optimal

state string

Severity level: minimal, low, medium, high

factors Factor[]

Breakdown of factors contributing to the score

scoreDateTime datetime

Date for which the score was calculated (ISO 8601)

dataSources string[]

Data sources used (e.g., age, sleep, activity)

createdAtUtc datetime

UTC timestamp when the entry was created

version float

Version of the scoring algorithm

Example Response

json

{
	"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
	"profileId": "p1q2r3s4-t5u6-7890-vwxy-z1234567890",
	"type": "sleep",
	"score": 0.85,
	"state": "high",
	"factors": [
		{
			"name": "sleep_duration",
			"value": 7.5,
			"goal": 8.0,
			"unit": "hour",
			"score": 0.94,
			"state": "high"
		}
	],
	"scoreDateTime": "2024-09-03T00:00:00+05:00",
	"dataSources": ["age", "sleep"],
	"createdAtUtc": "2024-09-03T05:30:00Z",
	"version": 1.1
}

Factor Schema

Each factor in the factors array follows this structure:

name string

Factor type (e.g., sleep_duration, activity_steps)

value float nullable

The actual measured value

goal float nullable

Target value for this factor

unit string

Unit of measurement (hour, count, etc.)

score float nullable

Factor score from 0.0 to 1.0 where 1.0 is optimal

state string nullable

Factor state: minimal, low, medium, high

Example Factor

json

{
	"name": "sleep_duration",
	"value": 7.5,
	"goal": 8.0,
	"unit": "hour",
	"score": 0.94,
	"state": "high"
}

FAQ

How often are scores updated?

Real-time—within 1 minute of new data arriving.

Do users need a wearable?

No. Scores work with smartphone data alone. Wearables add more factors (like heart rate) but aren't required.

What if data is missing?

Scores adapt. If a factor can't be calculated, it returns null and the score adjusts. A minimum of 3 factors is needed.

Can scores be used for medical diagnosis?

No. Scores are wellness indicators, not diagnostic tools. They're designed to inform and motivate, not diagnose.

Getting Started

API

Query scores on-demand for any profile

Webhooks

Receive scores automatically as they're generated

Widgets

Display scores with pre-built UI components

Explore each score's dedicated page for factors, data requirements, and integration details—start with Activity or Sleep .

Support

For assistance or queries about Scores, please reach out in the slack community or contact support@sahha.ai .