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.
URL: Visit APIs.json
Run: Capabilities Using Naftiko
- Activity, Biometrics, Cardiovascular, Fitness, Health, HRV, Quantified Self, Readiness, Resilience, Ring, Sleep, SpO2, Stress, Wearables, Wellness, Women's Health
- Created: 2026-05-25
- Modified: 2026-05-25
Retrieve the authenticated user's static profile (age, weight, height, biological sex, email) via /v2/usercollection/personal_info.
Human URL: https://cloud.ouraring.com/v2/docs
Per-day scored summaries: daily_activity, daily_sleep, daily_readiness, daily_resilience, daily_stress, daily_spo2, daily_cardiovascular_age, vO2_max. List by date range or fetch by document_id.
Human URL: https://cloud.ouraring.com/v2/docs
Detailed sleep period documents (HRV, respiratory rate, stages, movement), recommended sleep_time windows, and user-defined rest_mode_period blocks.
Human URL: https://cloud.ouraring.com/v2/docs
Auto-detected and manual workouts (/v2/usercollection/workout) plus guided sessions — meditation, breathwork, reset (/v2/usercollection/session).
Human URL: https://cloud.ouraring.com/v2/docs
Continuous heart-rate samples and interbeat interval (RR) time series.
Human URL: https://cloud.ouraring.com/v2/docs
Legacy free-text tags and structured enhanced tags (typed categories: ailment, lifestyle, nutrition, etc.).
Human URL: https://cloud.ouraring.com/v2/docs
Ring hardware metadata (color, design, firmware, hardware type) and battery level samples.
Human URL: https://cloud.ouraring.com/v2/docs
Create, list, get, update, renew, and delete webhook subscriptions. Each subscription pairs a data_type with an event_type (create / update / delete) and posts to a developer callback URL.
Human URL: https://cloud.ouraring.com/v2/docs
Mirror of the production usercollection surface under /v2/sandbox/usercollection/* that returns deterministic sample data — useful for CI, demos, and developing without a real ring.
Human URL: https://cloud.ouraring.com/v2/docs
- OAuth 2.0 —
https://cloud.ouraring.com/oauth/authorize(authorize),https://api.ouraring.com/oauth/token(token),https://api.ouraring.com/oauth/revoke(revoke). Scopes:email,personal,daily,heartrate,workout,tag,session,spo2. - Personal Access Tokens — long-lived bearer tokens generated from a user's developer dashboard for personal projects.
Both authentication mechanisms send the credential as Authorization: Bearer <token> and count against the same per-token rate limit.
- 5,000 requests per 5-minute window per access token.
- Heavy time-series endpoints (
heartrate,interbeat_interval) should be paginated vianext_token; webhooks are preferred over polling for state changes.
See rate-limits/oura-ring-rate-limits.yml.
- Oura Ring 4 — $349 (titanium) / $499 (Ceramic); FSA/HSA eligible.
- Oura Membership — $5.99/month or $69.99/year; required to unlock full insights in the Oura App.
- Oura for Teams — quoted enterprise program for organizations, research cohorts, and sports teams.
- Oura Developer Cloud — free API tier, no per-call charges.
See plans/oura-ring-plans-pricing.yml and finops/oura-ring-finops.yml.
FN: Kin Lane
Email: info@apievangelist.com