> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.thymia.ai/helios/llms.txt.
> For full documentation content, see https://docs.thymia.ai/helios/llms-full.txt.

# Interpreting Results

When a Helios model run completes with status `COMPLETE_OK`, the
response contains a `results` object with biomarker scores for the
recording. This page explains the structure of those results, how
scores are calculated, and how to use them responsibly.

## Results structure

Results are returned as an array of `sections`, each covering a timed
segment of the recording. Currently, Helios always returns a single
section covering the full recording.

```json
{
  "results": {
    "sections": [
      {
        "startSecs": 0,
        "finishSecs": 28.6,
        "transcript": "The North Wind and the Sun had a quarrel...",
        "mentalStrain": { "value": 0.42 },
        "distress": { "value": 0.33 },
        "stress": { "value": 0.33 },
        "exhaustion": { "value": 0.66 },
        "sleepPropensity": { "value": 0.66 },
        "lowSelfEsteem": { "value": 0.0 },
        "uniformDistress": { "value": 0.48 },
        "uniformStress": { "value": 0.39 },
        "uniformExhaustion": { "value": 0.61 },
        "uniformSleepPropensity": { "value": 0.58 },
        "uniformLowSelfEsteem": { "value": 0.21 }
      }
    ]
  }
}
```

Each section contains:

| Field        | Description                                                               |
| ------------ | ------------------------------------------------------------------------- |
| `startSecs`  | Time in seconds from the start of the recording where this section begins |
| `finishSecs` | Time in seconds from the start of the recording where this section ends   |
| `transcript` | Transcription of speech within this section                               |

## Biomarker scores

| Biomarker         | Description                                                                     |
| ----------------- | ------------------------------------------------------------------------------- |
| `mentalStrain`    | Overall measure of mental wellness — the composite signal across all dimensions |
| `distress`        | Levels of worry, nervousness or feeling on edge                                 |
| `stress`          | How anxious or wound up the user may feel; ability to relax                     |
| `exhaustion`      | Physical and mental tiredness resulting from manual or cognitive labour         |
| `sleepPropensity` | Likelihood of falling asleep if given the opportunity; linked to sleep quality  |
| `lowSelfEsteem`   | How confident and capable the user feels in themselves                          |

## Bucketed scores

Five biomarkers — `distress`, `stress`, `exhaustion`,
`sleepPropensity`, and `lowSelfEsteem` — are returned as one of four
discrete values:

| Value  | Label           |
| ------ | --------------- |
| `0.0`  | Low             |
| `0.33` | Moderately low  |
| `0.66` | Moderately high |
| `1.0`  | High            |

Bucketed scores are benchmarked against a matched population in
thymia's database — users of the same age, birth sex, and language
or accent.

<Warning>
  Benchmarking accuracy depends directly on the quality of demographic
  data supplied when creating the model run. Inaccurate `dateOfBirth`,
  `birthSex`, or `language` values will result in comparisons against
  a mismatched population and less reliable scores.
</Warning>

## Continuous scores

The same five biomarkers are also returned as continuous values under
the `uniform` prefix — for example, `uniformDistress`,
`uniformExhaustion`. These can take any value between `0` and `1`.

`mentalStrain` is returned only as a continuous score and has no
bucketed equivalent.

## Score interpretation guide

| Score range   | Interpretation                                               |
| ------------- | ------------------------------------------------------------ |
| `0.0 – 0.25`  | Low — within normal range for matched population             |
| `0.25 – 0.50` | Moderately low — slightly elevated                           |
| `0.50 – 0.75` | Moderately high — notably elevated, worth monitoring         |
| `0.75 – 1.0`  | High — significantly elevated relative to matched population |

<Note>
  Helios scores reflect the user's state at the time of recording.
  They are point-in-time measurements and should be interpreted in
  the context of longitudinal trends where possible.
</Note>

## Longitudinal monitoring

Helios is designed for continuous monitoring. Submitting regular
recordings for the same `userLabel` over time allows you to track
changes in a user's wellbeing state and identify meaningful trends.

For safety-critical applications, we recommend establishing a baseline
for each user over several sessions before acting on individual
readings.

## Responsible use

<Warning>
  Helios is a wellness monitoring tool. It is not a regulated medical
  device and must not be used for clinical diagnosis or as a substitute
  for clinical judgement. Results should not be presented to users as
  diagnostic or predictive of any medical condition.

  For clinical assessment of depression and anxiety, see
  [Apollo](/apollo/overview).
</Warning>

## Next steps

* [Error Reference](/helios/error-reference) — Handle
  `COMPLETE_ERROR` responses correctly in your integration.
* [Apollo](/apollo/overview) — For clinical-grade assessment
  of depression and anxiety.
* [API Reference](/api-reference) — Complete endpoint
  documentation for the Helios API.

<div>
  ***
</div>

<div>
  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/bc677a592c05a522bf7c895b7e9f00da344a3487d5e6baf5e35f4b013bf0e0e5/docs/assets/certs/crown-commerical-logo.png" alt="Crown Commercial Service" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/0fd8cd1c5e2bf5fe9c88a9671b5d62d76ee00fff93b057d3f28295f6e74a8e54/docs/assets/certs/nhs-digital-toolkit-logo.png" alt="NHS Digital" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/3408b37c11afb0482b6108012fdea2edc6843ffa1a6a485d9440f2c28067165c/docs/assets/certs/iso-27001-logo.png" alt="ISO 27001" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/f82c2989ef0c7907f8acc1bf38c1debfb8061a0bad0fd4aff7a724794739e5b0/docs/assets/certs/iso-13485-logo.png" alt="ISO 13485" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/44816901d032fd0dc4b99030c62e6841d10b1796fde6dd1615bf23eb84f9114b/docs/assets/certs/HIPPA-logo.png" alt="HIPAA" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/1c6800dfced2f3bd97bd907302e2ae105c99ed91fd381e0cd64eef7886394779/docs/assets/certs/gdpr-logo.png" alt="GDPR" />

  <img src="https://files.buildwithfern.com/https://thymia.docs.buildwithfern.com/2276326b82aee8a143219440498266a25a1425c423a6854489e706af50d38118/docs/assets/certs/cyber-essentials-logo.png" alt="Cyber Essentials Certified" />
</div>