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
  - type: NaftikoCapability
    url: capabilities/personal-info.yaml
  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
  - type: NaftikoCapability
    url: capabilities/daily-summaries.yaml
  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
  - type: NaftikoCapability
    url: capabilities/sleep.yaml
  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
  - type: NaftikoCapability
    url: capabilities/activity.yaml
  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
  - type: NaftikoCapability
    url: capabilities/heart-rate.yaml
  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
  - type: NaftikoCapability
    url: capabilities/tags.yaml
  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
  - type: NaftikoCapability
    url: capabilities/ring-configuration.yaml
  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
  - type: NaftikoCapability
    url: capabilities/webhooks.yaml
  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
  - type: NaftikoCapability
    url: capabilities/sandbox.yaml
  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-productions2.s3.amazonaws.com/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'