{"what":"The Vitality Dictionary: the plain-English meaning of every field Vitality serves. No naked numbers.","shelves":["briefing","sleep","recovery","workouts","activity","body","profile","trends"],"dictionary":{"common":{"provider":{"meaning":"which connected device/app supplied this record (informational only)"},"external_id":{"meaning":"stable id of this record, for de-duplication by consumers"},"synced_at":{"meaning":"when Vitality last pulled this record from the device, ISO 8601 UTC"},"started_at":{"meaning":"when this record began, ISO 8601 UTC"},"ended_at":{"meaning":"when this record ended, ISO 8601 UTC"},"generated_at":{"meaning":"the exact moment Vitality produced this response, ISO 8601 UTC — compare timestamps to this, never guess the current time"},"freshness":{"meaning":"per-device sync stamps: synced_at (absolute) + minutes_before_this_response (server-computed gap)"},"minutes_before_this_response":{"meaning":"how many minutes before generated_at this device last synced — precomputed by the server so nothing has to know the current time","unit":"minutes"},"days":{"meaning":"how many days of history this response covers"},"briefing":{"meaning":"a short plain-words snapshot of this member right now; values arrive pre-explained"},"avg_heart_rate":{"meaning":"average heart rate over the period","unit":"beats per minute"},"max_heart_rate":{"meaning":"highest heart rate over the period","unit":"beats per minute"},"calories":{"meaning":"energy burned","unit":"kilocalories"}},"sleep":{"duration_minutes":{"meaning":"actual time asleep (excludes time awake in bed)","unit":"minutes"},"time_in_bed_minutes":{"meaning":"total time in bed, asleep or not","unit":"minutes"},"efficiency_pct":{"meaning":"share of time in bed actually spent asleep","unit":"percent","range":"0-100","direction":"higher is better"},"score":{"meaning":"overall sleep quality for the night as scored by the member’s device","range":"0-100","direction":"higher is better"},"is_nap":{"meaning":"true when this session is a nap rather than a main night sleep"},"stages":{"meaning":"minutes spent in each sleep stage: light_min, deep_min, rem_min, awake_min"},"light_min":{"meaning":"light sleep (body restoring, easy to wake)","unit":"minutes"},"deep_min":{"meaning":"deep sleep (physical repair; hardest to wake from)","unit":"minutes"},"rem_min":{"meaning":"REM sleep (dreaming; mental recovery)","unit":"minutes"},"awake_min":{"meaning":"time awake during the sleep session","unit":"minutes"},"respiratory_rate":{"meaning":"breaths per minute while asleep","unit":"breaths per minute"},"consistency_pct":{"meaning":"how similar recent bed/wake times are to each other","unit":"percent","range":"0-100","direction":"higher is better"},"disturbance_count":{"meaning":"number of times sleep was disturbed during the session"},"sleep_cycle_count":{"meaning":"number of full sleep cycles completed"},"sleep_need_minutes":{"meaning":"how much sleep the body needed that night, per the device’s model","unit":"minutes"},"sleep_debt_minutes":{"meaning":"accumulated shortfall versus sleep need","unit":"minutes","direction":"lower is better"}},"recovery":{"scored_at":{"meaning":"the day this readiness score applies to, ISO 8601 UTC"},"score":{"meaning":"how recovered the body is today: under 34 low, 34-66 moderate, 67+ high (bands are the device maker’s own)","range":"0-100","direction":"higher is better"},"hrv_ms":{"meaning":"heart-rate variability during sleep — a key recovery signal","unit":"milliseconds","direction":"higher is better"},"resting_heart_rate":{"meaning":"lowest stable heart rate during sleep","unit":"beats per minute","direction":"lower is generally better"},"spo2_pct":{"meaning":"blood oxygen saturation during sleep","unit":"percent","range":"0-100"},"skin_temp_c":{"meaning":"skin temperature reading (some devices report deviation from personal baseline rather than absolute)","unit":"degrees Celsius"},"user_calibrating":{"meaning":"true while the device is still learning this member’s baseline — treat scores as provisional"}},"workouts":{"sport":{"meaning":"the movement/activity name (e.g. running, weightlifting)"},"strain":{"meaning":"how hard this workout was on the body, on a 0-21 exertion scale: under 10 light, 10-13.9 moderate, 14-17.9 hard, 18+ all-out","range":"0-21","direction":"higher is harder"},"distance_meters":{"meaning":"distance covered","unit":"meters"},"percent_recorded":{"meaning":"share of the workout with good sensor signal","unit":"percent","range":"0-100"},"altitude_gain_meters":{"meaning":"total climb during the workout","unit":"meters"},"altitude_change_meters":{"meaning":"net altitude change start to finish","unit":"meters"},"hr_zones":{"meaning":"minutes spent in each heart-rate zone during the workout (zone map keyed by zone name)"}},"activity":{"day_strain":{"meaning":"how hard the WHOLE day was on the body (all movement, not just workouts), on a 0-21 scale: under 10 light, 10-13.9 moderate, 14-17.9 hard, 18+ all-out","range":"0-21","direction":"higher is harder"},"kilojoule":{"meaning":"total day energy output","unit":"kilojoules"}},"body":{"height_meters":{"meaning":"the member’s standing height","unit":"meters"},"weight_kilograms":{"meaning":"the member’s body weight","unit":"kilograms"},"max_heart_rate":{"meaning":"estimated maximum heart rate","unit":"beats per minute"}},"profile":{"name":{"meaning":"the member’s name as their device reports it"},"connections":{"meaning":"the member’s connected devices with status and last sync time"},"status":{"meaning":"connection state of a device (connected / revoked)"},"connected_at":{"meaning":"when this device was first connected, ISO 8601 UTC"},"last_synced_at":{"meaning":"when this device last delivered data, ISO 8601 UTC"},"note":{"meaning":"a plain-words reminder of how Vitality serves this data"}},"trends":{"this_week":{"meaning":"averages/totals for the last 7 days"},"last_week":{"meaning":"averages/totals for the 7 days before that"},"week_over_week_change":{"meaning":"this week minus last week for each metric (positive = up)"},"avg_score":{"meaning":"average of the daily scores in the window","range":"0-100"},"avg_duration_minutes":{"meaning":"average nightly sleep duration","unit":"minutes"},"nights":{"meaning":"number of main sleeps (naps excluded) in the window"},"avg_hrv_ms":{"meaning":"average heart-rate variability","unit":"milliseconds","direction":"higher is better"},"avg_resting_heart_rate":{"meaning":"average resting heart rate","unit":"beats per minute"},"count":{"meaning":"number of workouts in the window"},"total_strain":{"meaning":"summed workout exertion for the window (each workout scored 0-21)"},"total_calories":{"meaning":"summed workout energy","unit":"kilocalories"},"avg_day_strain":{"meaning":"average whole-day exertion","range":"0-21","direction":"higher is harder"},"avg_calories":{"meaning":"average daily energy burned","unit":"kilocalories"},"sleep_score":{"meaning":"change in average sleep score vs last week"},"sleep_duration_minutes":{"meaning":"change in average sleep duration vs last week","unit":"minutes"},"recovery_score":{"meaning":"change in average recovery score vs last week"},"hrv_ms":{"meaning":"change in average HRV vs last week","unit":"milliseconds"},"resting_heart_rate":{"meaning":"change in average resting heart rate vs last week","unit":"beats per minute"},"workout_count":{"meaning":"change in number of workouts vs last week"},"day_strain":{"meaning":"change in average day exertion vs last week (0-21 scale)"}},"briefing":{"briefing":{"meaning":"a short plain-words snapshot of this member right now; values arrive pre-explained"}}}}