Lifestack
docs

Oura Ring Metrics Reference

Detailed reference for all nine Oura data types synced by Lifestack.

This is a complete reference of every metric Lifestack syncs from your Oura Ring. For an overview of the integration, see the Oura Ring integration page. For how these metrics feed into your Biological Capacity score, see Health Tracking.

Sleep

Daily sleep data captured from your Oura Ring's sleep tracking.

MetricTypeDescription
score0-100Overall sleep score combining all contributors
total_hoursDecimalTotal time asleep in hours
deep_hoursDecimalTime in deep (N3) sleep
rem_hoursDecimalTime in REM sleep
light_hoursDecimalTime in light (N1/N2) sleep
awake_hoursDecimalTime awake during the night
contributor_efficiency0-100How efficiently you slept (time asleep vs. time in bed)
contributor_latency0-100How quickly you fell asleep
contributor_timing0-100How well your sleep aligned with your optimal window
contributor_deep_sleep0-100Whether you got enough deep sleep
contributor_rem_sleep0-100Whether you got enough REM sleep
contributor_restfulness0-100How restful your sleep was (movement, wake-ups)

Readiness

Your daily readiness score and the factors that determine it.

MetricTypeDescription
score0-100Overall readiness score for the day
temperature_deviationDecimal (C)Deviation from your personal temperature baseline
temperature_trend_deviationDecimal (C)Trend in temperature deviation over recent days
activity_balance0-100Whether your recent activity level is sustainable
body_temperature0-100Body temperature contributor to readiness
hrv_balance0-100Heart rate variability relative to your baseline
previous_day_activity0-100Impact of yesterday's activity on today's readiness
previous_night0-100How last night's sleep affects readiness
recovery_index0-100How well your resting heart rate recovered overnight
resting_heart_rate0-100Resting HR contributor (lower relative to baseline is better)
sleep_balance0-100Whether you have been getting enough sleep recently

Activity

Daily activity summaries including movement, calories, and time breakdowns.

MetricTypeDescription
score0-100Overall activity score for the day
active_caloriesInteger (kcal)Calories burned through activity (excludes BMR)
total_caloriesInteger (kcal)Total calories burned including basal metabolic rate
stepsIntegerTotal steps for the day
equivalent_walking_distanceInteger (meters)Total movement converted to equivalent walking distance
high_activity_timeInteger (min)Time spent in high-intensity activity
medium_activity_timeInteger (min)Time spent in medium-intensity activity
low_activity_timeInteger (min)Time spent in low-intensity activity
sedentary_timeInteger (min)Time spent sedentary
resting_timeInteger (min)Time spent resting

Heart Rate

Daily heart rate data with both aggregated stats and intraday samples.

MetricTypeDescription
min_bpmIntegerLowest heart rate recorded during the day
max_bpmIntegerHighest heart rate recorded during the day
avg_bpmIntegerAverage heart rate across the day
resting_bpmIntegerResting heart rate (measured during sleep and rest)
samplesJSON ArrayIntraday HR samples with timestamp, BPM, and source

Heart rate samples are aggregated into 30-minute buckets for the Energy Ring on the Event Horizon.

Sleep Time

Oura's optimal bedtime recommendations based on your patterns.

MetricTypeDescription
optimal_bedtime_startInteger (seconds)Start of optimal bedtime window (offset from midnight)
optimal_bedtime_endInteger (seconds)End of optimal bedtime window (offset from midnight)
recommendationStringSuggestion type (e.g., improve_efficiency, earlier_bedtime)
statusStringRecommendation status (not_enough_nights, optimal_found)

Sessions

Meditation, breathing, nap, and rest sessions recorded in the Oura app.

MetricTypeDescription
start_datetimeISO 8601When the session started
end_datetimeISO 8601When the session ended
duration_minutesIntegerSession length in minutes
session_typeStringType: breathing, meditation, nap, relaxation, rest, body_status
moodStringPost-session mood: bad, worse, same, good, great
avg_heart_rateInteger (BPM)Average heart rate during the session
min_heart_rateInteger (BPM)Minimum heart rate during the session
max_heart_rateInteger (BPM)Maximum heart rate during the session
avg_hrvInteger (ms)Average heart rate variability during the session

Tags

Custom tags you create in the Oura app to annotate your days.

MetricTypeDescription
timestampISO 8601When the tag was created
textStringCustom text input for the tag
tagsJSON ArrayPredefined tag selections from the Oura app

SpO2

Blood oxygen saturation data (requires Oura Ring Gen3 or later).

MetricTypeDescription
spo2_averageDecimal (%)Average blood oxygen saturation during sleep
breathing_disturbance_indexDecimalFrequency of breathing disturbances per hour of sleep

Daily Stress

Stress and recovery balance throughout the day.

MetricTypeDescription
stress_highInteger (sec)Total time spent in high stress state
recovery_highInteger (sec)Total time spent in high recovery state
day_summaryStringOverall day classification: restored, normal, or stressful