---
title: Scores
subtitle: Actionable measures of health and wellness
---


![Scores Hero](/images/products/scores/scores-hero.webp)

{% use-cases items="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](/docs/products/scores/wellbeing)     | Live   | Holistic health combining sleep, activity, and mental wellness   |
| [Activity](/docs/products/scores/activity)       | Live   | Daily physical activity—steps, calories, active hours, intensity |
| [Sleep](/docs/products/scores/sleep)             | Live   | Sleep quality—duration, regularity, stages, and recovery         |
| [Mental Wellbeing](/docs/products/scores/mental) | Live   | Mental wellness derived from sleep and activity patterns         |
| [Readiness](/docs/products/scores/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](/docs/get-started/data-dictionary) for all available outputs.

<!-- {% popover label="Status" trigger="hover" %}
| Status     | Description                       |
| ---------- | --------------------------------- |
| Live | Live and fully supported          |
| BETA       | Limited release, still in testing |
| Coming Soon | Future release, under research    |
{% /popover %} -->

---

## Key Features

{% cards smCols=2 %}

{% card title="Smartphone Compatible" description="Works with phones alone or wearables—reach 100% of your users without hardware requirements" /%}
{% card title="Explainable" description="Every score shows contributing factors—users understand the 'why' behind their number" /%}
{% card title="Real-time" description="Updates in under 1 minute—scores always reflect the user's current state" /%}
{% card title="Instant Value" description="14 days of retroactive scores on integration—users see insights from day one" /%}
{% card title="Actionable" description="Each factor includes goals—users know exactly what to improve" /%}
{% card title="Research-backed" description="Built on peer-reviewed research and validated for clinical accuracy" /%}

{% /cards %}

---

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

{% cards smCols=2 %}

{% card title="Personalized Coaching" description="Adapt recommendations based on which factors need improvement" /%}
{% card title="Gamification" description="Power challenges, streaks, and rewards tied to real health progress" /%}
{% card title="Insurance Underwriting" description="Assess policyholder wellness for dynamic pricing and risk models" /%}
{% card title="Employee Wellness" description="Track workforce health trends and measure program effectiveness" /%}
{% card title="Clinical Monitoring" description="Remotely track patient wellness between appointments" /%}
{% card title="User Engagement" description="Surface health insights that keep users coming back daily" /%}

{% /cards %}

---

## Output Schema

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

{% api-example %}

{% api-panel %}
{% api-property field="id" type="UUID" description="Unique identifier for each score entry" /%}
{% api-property field="profileId" type="UUID" description="Unique identifier for the associated profile" /%}
{% api-property field="accountId" type="UUID" description="Unique identifier for the account linked to the profile" /%}
{% api-property field="externalId" type="UUID" description="External identifier associated with the profile" /%}
{% api-property field="type" type="string" description="Type of score: activity, sleep, readiness, wellbeing, mental_wellbeing" /%}
{% api-property field="score" type="float" description="Calculated score from 0.0 to 1.0 where 1.0 is optimal" /%}
{% api-property field="state" type="string" description="Severity level: minimal, low, medium, high" /%}
{% api-property field="factors" type="Factor[]" description="Breakdown of factors contributing to the score" /%}
{% api-property field="scoreDateTime" type="datetime" description="Date for which the score was calculated (ISO 8601)" /%}
{% api-property field="dataSources" type="string[]" description="Data sources used (e.g., age, sleep, activity)" /%}
{% api-property field="createdAtUtc" type="datetime" description="UTC timestamp when the entry was created" /%}
{% api-property field="version" type="float" description="Version of the scoring algorithm" /%}
{% /api-panel %}

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

{% /api-example %}

### Factor Schema

Each factor in the `factors` array follows this structure:

{% api-example %}

{% api-panel %}
{% api-property field="name" type="string" description="Factor type (e.g., sleep_duration, activity_steps)" /%}
{% api-property field="value" type="float" nullable=true description="The actual measured value" /%}
{% api-property field="goal" type="float" nullable=true description="Target value for this factor" /%}
{% api-property field="unit" type="string" description="Unit of measurement (hour, count, etc.)" /%}
{% api-property field="score" type="float" nullable=true description="Factor score from 0.0 to 1.0 where 1.0 is optimal" /%}
{% api-property field="state" type="string" nullable=true description="Factor state: minimal, low, medium, high" /%}
{% /api-panel %}

```json {% title="Example Factor" %}
{
	"name": "sleep_duration",
	"value": 7.5,
	"goal": 8.0,
	"unit": "hour",
	"score": 0.94,
	"state": "high"
}
```

{% /api-example %}

---

## FAQ

{% faq %}

{% faq-item question="How often are scores updated?" %}
Real-time—within 1 minute of new data arriving.
{% /faq-item %}

{% faq-item question="Do users need a wearable?" %}
No. Scores work with smartphone data alone. Wearables add more factors (like heart rate) but aren't required.
{% /faq-item %}

{% faq-item question="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.
{% /faq-item %}

{% faq-item question="Can scores be used for medical diagnosis?" %}
No. Scores are wellness indicators, not diagnostic tools. They're designed to inform and motivate, not diagnose.
{% /faq-item %}

{% /faq %}

---

## Getting Started

{% action-cards %}

{% action-card icon="code" href="/docs/connect/api" title="API" description="Query scores on-demand for any profile" /%}

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

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

{% /action-cards %}

Explore each score's dedicated page for factors, data requirements, and integration details—start with [Activity](/docs/products/scores/activity) or [Sleep](/docs/products/scores/sleep).

---

## Support

For assistance or queries about Scores, please reach out in the [slack community](https://join.slack.com/t/sahhacommunity/shared_invite/zt-1w0fmfbvk-qUwQ83tJgXyjT9XSxJvKIw) or contact [support@sahha.ai](mailto:support@sahha.ai).