Overview Statistics

The Overview is a long term view of the data. For this purpose, data is aggregated on the day-level.

In the NOWATCH app, the Overview is conceptually split in two sections:

• Awake Section (More info in our Support Knowledge Base):
  • Stress Duration: amount of time the user was under stress;
  • Stress Recovery: amount of time it took the user to recover from stressors, on average;
  • Stress Frequency: number of detected stressors;
  • Intense Activity: total minutes of intense activity;
  • Resting Heart Rate: Heart Rate under sustained rest;
• Asleep Section (More info in our Support Knowledge Base):
  • Sleep Heart Rate Variability (HRV): HRV while sleeping;
  • Sleep Duration: amount of time the user was asleep;
  • Sleep Regularity: awake time and bedtime;
  • Skin Temperature: skin temperature deviation from the personal baseline while asleep;

For each metric (eg, stress, activity, sleep, etc.), you get:

• Daily values (provided there is a minimum 6 hours of wear time throughout the day);
• A typical value and/or range: given the last N days, what is the expected range of values for a metric for a user.

More info in our Support Knowledge Base

Overview Data Structure

Overview data is fetched one type at a time: GET /v1/overview/{user_id}/{type}. Each request returns a list of daily records for that single type, and every record is a flat object keyed by date plus that type's own metric fields. See the Overview API reference for the exact response of each type.

The available stype values:

stype	Section	Description
HRV	Asleep	Heart rate variability during sleep
SLEEP_DURATION	Asleep	Time asleep
SLEEP_REGULARITY	Asleep	Bedtime / waketime regularity
SKIN_TEMPERATURE	Asleep	Skin temperature deviation from baseline
RHR	Awake	Resting heart rate
STRESS_DURATION	Awake	Time under stress
STRESS_RECOVERY	Awake	Time to recover from stressors
STRESS_FREQUENCY	Awake	Number of stressors
INTENSE_ACTIVITY	Awake	Intense-activity minutes / regularity

For each metric you typically get, as flat fields on the record:

• a daily value (*_daily), provided there was at least 6 hours of wear time that day;
• a typical value (*_typical) and, where applicable, upper/lower deviations (*_upper_deviation / *_lower_deviation) describing the expected range.

Typical Range

Where a metric provides a typical value and deviations, the expected range is:

• lower limit: *_typical - *_lower_deviation;
• upper limit: *_typical + *_upper_deviation.

{
  "date": "2023-01-01",
  "hrv_daily": 40.5,
  "hrv_typical": 42.0,
  "hrv_upper_deviation": 5.0,
  "hrv_lower_deviation": 3.0
}

Field Units

Each numeric overview field carries an implicit unit. The same unit appears as the x-unit extension on the corresponding property in the OpenAPI spec, so SDK generators and contract tests can pick it up.

Field family	Unit	Notes
hrv_* (numeric)	ms	RMSSD heart-rate variability, in milliseconds.
rhr_* (numeric)	bpm	Resting heart rate, beats per minute.
stress_duration_*	min	Minutes spent under stress.
stress_recovery_*	min	Minutes spent recovering from stressors.
stress_frequency_daily	count	Number of stressor events that day.
sleep_duration_*	min	Minutes asleep.
intense_activity_daily	min	Minutes of intense activity.
intense_activity_regularity	ratio	0–1 score for how regular the user's intense-activity pattern is.
intense_activity_label	–	Activity band derived from regularity: NOT_ACTIVE, SOMEWHAT_ACTIVE, or ACTIVE; empty when regularity is unknown.
skin_temperature_*	celsius	Deviation from the personal skin-temperature baseline: daily deviation plus lower/upper deviation bounds (no separate _typical).
sleep_bedtime_typical, sleep_waketime_typical	hour	Hour of day as a float (9.0 = 09:00, 0.0 = midnight).
sleep_bedtime_daily, sleep_waketime_daily	datetime	ISO 8601 datetime string.