Get daily activity: activity score (0-100) and contributors, steps, active and total calories (kcal), equivalent walking distance (meters), time in high, medium and low activity and sedentary (seconds), MET minutes, and inactivity alerts.

Get workouts, auto detected or entered by the user: activity type, start and end time, calories, distance (meters), intensity, and source.

Get guided and unguided sessions from the Oura app (breathing, meditation, rest, etc.): type, start and end time, and mood. Set include_time_series for the heart rate, HRV and motion recorded during each session.

Get instructions for connecting this server to an Oura account.

Report whether an Oura session is stored, which scopes it has, and when it expires.

Never returns token values. The access token refreshes automatically, so an expired access token with a stored refresh token is still a working session.

Get one Oura document by id, with every field including embedded time series. Use it to drill into a single sleep period, workout or session from a list result.

Get heart rate samples (bpm) at roughly 5 minute intervals, each tagged with its source: awake, rest, sleep, workout, session or live. Defaults to the last 24 hours.

Get daytime stress: seconds spent in high stress and in high recovery each day, and a day summary of restored, normal or stressful.

Get average blood oxygen saturation (SpO2 %) during sleep and the breathing disturbance index. Requires a Gen 3 or later ring.

Get cardiovascular age: Oura's estimate of vascular age in years, from pulse wave velocity, to compare against actual age.

Get VO2 max (cardio capacity) estimates in ml/kg/min. Updated infrequently.

Get the signed in user's profile: age, weight, height, biological sex and email. Fields the user did not grant a scope for come back null.

Get the user's ring(s): hardware generation, color, design, size, firmware and setup date.

Get ring battery level (%) and charging state. Returns the latest reading by default; set latest to false for readings over a window.

Get tags the user logged in the Oura app (caffeine, alcohol, illness, travel, custom tags, etc.) with start and end times and comments. Useful for explaining changes in sleep or readiness.

Get rest mode periods (when the user turned on rest mode, typically for illness or recovery), with start and end times and logged episodes.

Get daily readiness scores (0-100) with contributors (activity balance, body temperature, HRV balance, previous day activity, previous night, recovery index, resting heart rate, sleep balance, sleep regularity) and body temperature deviation from baseline in degrees Celsius.

Get daily resilience: an estimate of the ability to withstand and recover from physiological stress, as a level (limited, adequate, solid, strong, exceptional) with sleep recovery, daytime recovery and stress contributors.

Get daily sleep scores (0-100) with their contributors: deep sleep, efficiency, latency, REM sleep, restfulness, timing and total sleep.

For durations, stages, heart rate and HRV use get_sleep_periods.

Get detailed sleep periods: bedtime start and end, total, deep, REM and light sleep durations (seconds), awake time, latency, efficiency, average and lowest heart rate, average HRV, breathing rate, and the readiness computed from that sleep.

A day can have several periods. type 'long_sleep' is the main sleep; naps and short rests appear as 'sleep', 'late_nap' or 'rest'.

Get Oura's recommended bedtime window for each day, calculated from recent sleep.

Get one record per day combining the headline numbers: sleep, readiness and activity scores, steps and calories, stress and recovery time, SpO2, resilience level, temperature deviation, and the main sleep period (bedtime, durations, efficiency, HRV, heart rate). Durations are in seconds.

The best starting point for questions like "how have I been sleeping" or "how was my week". Collections the session has no scope for are listed under 'unavailable' and the rest are still returned.