Oura
Cloud API · sources read 2026-10-17 · guideDelivery
History and backfill
- One request for history when a user connects, then webhooks; depth not stated — “Make a single request for historical data when a user first connects, then use webhooks for ongoing updates” (source)
- Fetch history in ranges of about 1 to 3 months — “Use date range queries with reasonable time spans (e.g., 1-3 months at a time)” (source)
Data resolution
- Heart rate: 5-minute increments — “Heart rate is provided at 5-minute increments.” (source)
- Steps and daily activity: Daily summary — “The Daily Activity scope includes daily activity summary values and detailed activity levels.” (source)
- Blood oxygen (SpO2): Daily average — “The Daily SpO2 (blood oxygenation) routes include daily SpO2 average. Data will only be available for users with a Gen 3 Oura Ring” (source)
- Stress, recovery or readiness: Daily — “The daily stress route includes a summary of the number of minutes the user spends in high stress and high recovery each day.” (source)
Metrics
- Heart rate: Time-series heart rate — “Heart rate is provided at 5-minute increments.” (source)
- Sleep: Sleep periods; a user can have several a day — “A user can have multiple sleep periods per day.” (source)
- Steps and daily activity: Daily activity summary and activity levels — “The Daily Activity scope includes daily activity summary values and detailed activity levels.” (source)
- Blood oxygen (SpO2): Daily SpO2 average, Gen 3 ring only — “The Daily SpO2 (blood oxygenation) routes include daily SpO2 average. Data will only be available for users with a Gen 3 Oura Ring” (source)
- Weight and body composition: Weight and height in personal info — “The Personal Info scope includes personal information (e.g. age, email, weight, and height) about the user.” (source)
- VO2 max: VO2 max route — “VO2 Max is a measure of the maximum volume of oxygen that an individual can use during intense exercise.” (source)
- Stress, recovery or readiness: Daily minutes in high stress and high recovery — “The daily stress route includes a summary of the number of minutes the user spends in high stress and high recovery each day.” (source)