Oura

aid: oura-ring
url: https://raw.githubusercontent.com/api-evangelist/oura-ring/refs/heads/main/apis.yml
apis:
  - aid: oura-ring:oura-personal-info-api
    name: Oura Personal Info API
    tags:
      - Health
      - Personal Info
      - User
      - Wearables
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Retrieve the authenticated user's Oura profile including age, weight, height, biological sex, and email via
      /v2/usercollection/personal_info. Returned with the personal scope and represents the static profile metadata
      associated with the Oura account.
  - aid: oura-ring:oura-daily-summaries-api
    name: Oura Daily Summaries API
    tags:
      - Activity
      - Cardiovascular Age
      - Daily
      - Health
      - Readiness
      - Resilience
      - Sleep
      - SpO2
      - Stress
      - VO2 Max
      - Wearables
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Per-day scored summaries derived from Oura Ring sensor data — daily_activity, daily_sleep, daily_readiness,
      daily_resilience, daily_stress, daily_spo2, daily_cardiovascular_age, and vO2_max. Each document collection
      supports list with start_date/end_date and individual document retrieval by document_id.
  - aid: oura-ring:oura-sleep-api
    name: Oura Sleep API
    tags:
      - Health
      - Rest Mode
      - Sleep
      - Sleep Time
      - Wearables
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Detailed sleep period documents from the ring including HRV, respiratory rate, sleep stages, and movement plus
      recommended sleep_time windows and user-defined rest_mode_period blocks. Endpoints under /v2/usercollection/sleep,
      /v2/usercollection/sleep_time, and /v2/usercollection/rest_mode_period.
  - aid: oura-ring:oura-activity-api
    name: Oura Activity API
    tags:
      - Activity
      - Fitness
      - Health
      - Sessions
      - Wearables
      - Workouts
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Workout, session (meditation/breathwork/reset), and movement data captured by the Oura Ring.
      /v2/usercollection/workout returns auto-detected and manually logged workouts; /v2/usercollection/session returns
      guided sessions with intensity and labels.
  - aid: oura-ring:oura-heart-rate-api
    name: Oura Heart Rate API
    tags:
      - Health
      - Heart Rate
      - HRV
      - Interbeat Interval
      - Time Series
      - Wearables
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Continuous heart-rate samples and interbeat interval (RR) data captured by the Oura Ring.
      /v2/usercollection/heartrate returns datetime-bounded BPM samples; /v2/usercollection/interbeat_interval returns
      the underlying IBI time series used for HRV calculation.
  - aid: oura-ring:oura-tags-api
    name: Oura Tags API
    tags:
      - Annotations
      - Enhanced Tags
      - Health
      - Tags
      - Wearables
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      User-authored annotations attached to specific days or events — legacy /v2/usercollection/tag and structured
      /v2/usercollection/enhanced_tag. Tags carry custom text, comments, and (for enhanced tags) typed categories like
      ailment, lifestyle, or nutrition.
  - aid: oura-ring:oura-ring-api
    name: Oura Ring Configuration API
    tags:
      - Battery
      - Hardware
      - Ring
      - Telemetry
      - Wearables
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Metadata about the Oura Ring hardware itself — color, design, firmware version, hardware type, set id, and ring
      battery level samples — via /v2/usercollection/ring_configuration and /v2/usercollection/ring_battery_level.
  - aid: oura-ring:oura-webhooks-api
    name: Oura Webhooks API
    tags:
      - Events
      - Notifications
      - Subscriptions
      - Webhooks
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Create, list, renew, update, and delete event subscriptions over /v2/webhook/subscription. Each subscription
      targets a data_type (sleep, activity, readiness, tag, workout, session, daily_*, heartrate, etc.) and an
      event_type (create, update, delete) and posts events to a developer-controlled callback URL with HMAC
      verification.
  - aid: oura-ring:oura-sandbox-api
    name: Oura Sandbox API
    tags:
      - Sandbox
      - Sample Data
      - Testing
      - Wearables
    humanURL: https://cloud.ouraring.com/v2/docs
    properties:
      - url: https://cloud.ouraring.com/v2/docs
        type: Documentation
      - url: openapi/oura-api-openapi.yml
        type: OpenAPI
    description: >-
      Mirror of the production usercollection endpoints under /v2/sandbox/usercollection/* that returns deterministic
      sample data without requiring a connected ring or real user consent. Used for integration testing, demos, and CI.
name: Oura
tags:
  - Activity
  - Biometrics
  - Cardiovascular
  - Fitness
  - Health
  - HRV
  - Quantified Self
  - Readiness
  - Resilience
  - Ring
  - Sleep
  - SpO2
  - Stress
  - Wearables
  - Wellness
  - Women's Health
kind: contract
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
  - type: Portal
    url: https://ouraring.com
  - type: Documentation
    url: https://cloud.ouraring.com/v2/docs
  - url: https://cloud.ouraring.com
    name: Oura Developer Cloud
    type: Portal
  - url: https://cloud.ouraring.com/docs
    name: Oura API Getting Started
    type: GettingStarted
  - url: https://cloud.ouraring.com/oauth/applications
    name: My Applications
    type: SignUp
  - url: https://cloud.ouraring.com/personal-access-tokens
    name: Personal Access Tokens
    type: Authentication
  - url: https://cloud.ouraring.com/v2/docs#tag/oauth2
    name: OAuth 2.0 - Oura Developer Cloud
    type: Authentication
  - url: https://cloud.ouraring.com/v2/docs#operation/Webhook_Subscription_Route
    name: Webhook Subscriptions - Oura Developer Cloud
    type: Webhooks
  - url: https://ouraring.com/blog
    name: The Pulse - Oura Blog
    type: Blog
  - url: https://ouraring.com/legal/privacy-policy
    type: PrivacyPolicy
  - url: https://ouraring.com/terms-and-conditions
    type: TermsOfService
  - url: https://ouraring.com/support
    type: Support
  - url: https://status.ouraring.com
    type: StatusPage
  - url: https://ouraring.com/research
    name: Oura Research
    type: Research
  - url: https://ouraring.com/teams
    name: Oura for Teams
    type: Enterprise
  - url: https://ouraring.com/lp/oura-health
    name: Oura Health
    type: Enterprise
  - url: https://ouraring.com/product/rings/oura-ring-4
    name: Oura Ring 4
    type: Product
  - url: https://ouraring.com/product/rings/oura-ring-4-ceramic
    name: Oura Ring 4 Ceramic
    type: Product
  - url: https://ouraring.com/oura-experience/app
    name: Oura App
    type: Product
  - url: https://www.linkedin.com/company/oura/
    type: LinkedIn
  - url: https://twitter.com/ouraring
    type: Twitter
  - url: https://www.instagram.com/ouraring/
    type: Instagram
  - url: https://www.youtube.com/@ouraring
    type: YouTube
  - url: https://www.facebook.com/ouraring/
    type: Facebook
  - url: plans/oura-ring-plans-pricing.yml
    type: Plans
  - url: rate-limits/oura-ring-rate-limits.yml
    type: RateLimits
  - url: finops/oura-ring-finops.yml
    type: FinOps
  - type: Features
    data:
      - Oura Ring 4 — titanium smart ring with continuous biometric sensing (PPG, body temperature, accelerometer, SpO2)
      - 50+ tracked health metrics across sleep, activity, readiness, stress, resilience, heart, and women's health
      - Daily Sleep score with sleep stages, latency, efficiency, HRV, respiratory rate, and lowest resting heart rate
      - Daily Activity score with movement, inactivity, training frequency, and equivalent walking distance
      - Daily Readiness score combining HRV balance, sleep balance, recovery index, and body temperature deviation
      - Daily Resilience score capturing long-term stress load and recovery capacity
      - Daily Stress with high/recovered/relaxed/restored minute-level classification
      - SpO2 nighttime monitoring with average and breathing-disturbance index
      - Cardiovascular Age and VO2 Max estimation from continuous heart-rate data
      - Cycle Insights and Period Prediction (women's health)
      - Symptom Radar early-illness detection based on temperature and respiratory deviation
      - Workouts (auto-detected and manual) and Sessions (meditation, breathwork, reset)
      - Tags and Enhanced Tags (typed user annotations — ailment, lifestyle, nutrition, etc.)
      - Rest Mode for recovery from illness or injury
      - Sleep Time recommendation window personalized to the user
      - REST API v2 with OAuth 2.0 (8 scopes) and Personal Access Tokens
      - >-
        Webhook subscriptions for sleep, activity, readiness, tag, workout, session, daily_*, heartrate
        (create/update/delete)
      - Sandbox endpoint family (/v2/sandbox/usercollection/*) returning deterministic sample data for testing
      - 5,000 requests / 5 minutes per access token rate limit
      - Oura Membership ($5.99/month or $69.99/year) unlocks full insights in the Oura App
      - Apple Health, Google Health Connect, Strava, Natural Cycles, and other native integrations
      - FSA/HSA eligibility on ring purchases in the US
      - Oura for Teams and Oura Health (enterprise wellness)
      - HIPAA-aligned data handling and SOC 2 controls
    sources:
      - https://ouraring.com/en
      - https://cloud.ouraring.com/v2/docs
      - https://cloud.ouraring.com/docs
      - https://ouraring.com/blog
    updated: '2026-05-25'
created: '2026-05-25T00:00:00.000Z'
modified: '2026-05-25'
position: Consuming
description: >-
  Oura is a health-technology company that makes the Oura Ring — a titanium smart ring packed with PPG,
  body-temperature, SpO2, and motion sensors — and the Oura App and Oura Cloud platform that turn raw biometrics into
  daily Sleep, Activity, Readiness, Stress, and Resilience scores. The Oura Developer Cloud exposes a v2 REST API and
  webhook subscriptions over OAuth 2.0 and Personal Access Tokens, letting third-party applications read 50+ health
  metrics, raw heart-rate and interbeat-interval time series, sleep stages, workouts, sessions, user-authored tags, and
  ring telemetry. A parallel /v2/sandbox/usercollection/* surface provides deterministic sample data for integration
  testing.
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com
    X: apievangelist
    url: https://apievangelist.com
specificationVersion: '0.16'