Device IntegrationHealthcare Interoperability

Oura Ring API Integration Guide 2026: Access and Data

September 30, 202617 min read
Written by
Jitendra Choudhary
Jitendra Choudhary

CTO & Co-Founder

CTO & Co-Founder at Nirmitee.io. Architects healthcare integrations across FHIR, SMART on FHIR, ABDM and NHCX, writing from production experience taking hospital software from sandbox to go-live.

Oura Ring API Integration Guide 2026: Access and Data

Yes, you can integrate Oura through the Oura API V2, which Oura calls "the only available integration point for Oura data". No developer fee is listed. You can build with up to 10 users before Oura must approve your app, and Oura has not published how long approval takes. Users with a Gen3 or later ring need an active Oura Membership, or the API returns nothing for them. The rule that decides most healthcare projects is the storage clause in the API agreement, which says you shall not store or cache data obtained through the MCP Server, so have counsel confirm how far it reaches before you plan to keep readings in an EHR. You need your own server, no SDK, and no mobile app of your own.

Want a team to build this for you? Our medical device integration services cover the vendor approval, the data pipeline and EHR delivery.

Oura integration at a glance

QuestionAnswer
Official API?Yes. Oura API V2 (REST, OAuth2, webhooks). V1 was removed on 22 Jan 2024.
Cost to the developerNo fee listed. Agreement 3(h): Oura reserves the right to charge fees.
Does the end user need a subscription or device?Yes. An Oura Ring, and for Gen3 and later an active Oura Membership.
Same-day start?Yes, for up to 10 users. Sandbox endpoints let you build without a ring.
Who approves scale-up?Oura. "There is no limit once an application is approved." Criteria and wait time not published.
HIPAA / BAAThe agreement does not mention HIPAA. BAA not published.
Raw or summary data?Mostly daily summaries and per-period sleep records. Heart rate is a time series. No raw PPG or accelerometer.
First buildAbout 3 weeks to a working integration (our estimate), plus legal review of storage and Oura approval.

Integration strategies

RouteOwn mobile app?Own server?Vendor approval or contract?SDK?LatencySupported dataNot supportedBest for
Oura API V2 (REST)No. Server-side OAuth from a web page works.Yes for the server flow. A client-side flow exists with 30-day tokens and no refresh.No for 10 users. Oura approval beyond that.NoAfter the user's Oura app syncs. Sleep needs the user to open the app.All V2 data types listed belowRaw sensors, ECG, writes, lapsed membersAny product reading Oura data
WebhooksNoYes, public HTTPS endpointSame as RESTNoAbout 30 seconds after the app syncsNotifications that new data is ready. You then fetch it with REST.Heart rate, personal info and ring battery level have no webhookFresh data without polling. Oura calls it "the preferred way".
Sandbox endpointsNoYesNoNon/aTest data in the same shapeReal usersBuilding before you have rings
Personal access tokensDeprecated December 2025 and "no longer available for use".
Phone SDKNot published.
Apple Health / Health ConnectYes, the Oura app reads and writes both. Apple Health gets active energy, heart rate, sleep and stages, steps, respiratory rate, mindful minutes, weight and workouts, but not HRV. Health Connect gets active calories, distance, exercise, steps, sleep, heart rate and HRV. Gen3 and later need an active membership.
Aggregators, checked 10 November 2026Terra, Junction, Thryve and ROOK list Oura as a cloud API source. Sahha has it in public beta, sandbox only. Spike lists it with no route stated. Validic lists Oura as restricted and not taking new applications. Pricing is not published. The Oura agreement says aggregators may not store or cache User Data or Oura Data.
Member file downloadNoNoNoNoManualWhatever the Membership Hub file holdsAnything ongoingOne-off research pulls by the user

For a wellness, sleep or coaching product, use the REST API with webhooks and the server-side OAuth flow. It is free today and the data set is broad. For a healthcare buyer, use the same route, but finish the legal read of the storage clause and the competing-product clause before you design storage, and plan for users whose membership lapses mid-program. Avoid aggregators if your plan depends on storing Oura data, since the agreement singles them out.

Build it yourself, use an aggregator, or work with a partner

QuestionBuild in-houseWearable aggregatorBuild with a partner (Nirmitee)
Whose Oura API app?YoursDepends on the aggregator. Some, such as Sahha, ask you to register your own Oura app.Yours. We build it in your account.
Storage clause riskYour counsel reads itHighest. The agreement names aggregators and bars them from storing or caching Oura data.Your counsel reads it. We design storage around the answer.
Webhooks and token renewalYou build and run themThe aggregator runs themWe build them, then hand them to you or run them
Data modelOura's own fieldsThe aggregator's schemaFHIR Observations for your EHR or remote monitoring stack
Other devices laterOne new build per deviceMany devices through one APISame pattern reused across devices
Time to first real userDepends on your teamDepends on the aggregator's onboardingAbout 3 weeks of build in our estimate, plus Oura approval past 10 users
Cost shapeEngineering timeAggregator fee. Pricing for Oura on these platforms is not published.Project fee, scoped after a call
Every way to get Oura data, and what each one needs.

What data you can get

From the OpenAPI spec 1.43. All paths sit under /v2/usercollection/.

Data (endpoint)ScopeGranularityHistory windowPush or pull
Daily activity (daily_activity)dailyDaily summaryNot publishedPull, webhook
Daily readiness (daily_readiness)dailyDaily summaryNot publishedPull, webhook
Daily sleep score (daily_sleep)dailyDaily summaryNot publishedPull, webhook
Sleep periods (sleep)dailyPer sleep period (fields such as sleep stages, HRV and respiratory rate. Full field list in the spec)Not publishedPull, webhook
Sleep time recommendation (sleep_time)dailyDailyNot publishedPull, webhook
Daily SpO2 (daily_spo2)spo2Daily average during sleepNot publishedPull, webhook
Daily stress (daily_stress)dailyDaily summaryNot publishedPull, webhook
Daily resilience (daily_resilience)dailyDaily summaryNot publishedPull, webhook
Cardiovascular age (daily_cardiovascular_age)heart_healthDailyNot publishedPull, webhook
VO2 max (vO2_max)heart_healthPer estimateNot publishedPull, webhook
Heart rate (heartrate)heartrateTime seriesNot publishedPull only. Heart rate is not in the webhook data type list.
Workouts (workout)workoutPer workoutNot publishedPull, webhook
Sessions (session)sessionPer sessionNot publishedPull, webhook
Tags and enhanced tags (tag, enhanced_tag)tagPer tagNot publishedPull, webhook
Rest mode periods (rest_mode_period)dailyPer periodNot publishedPull, webhook
Personal info (personal_info)personal, emailCurrent profile, including weight and heightn/aPull
Ring battery level, ring configurationNot publishedNot publishedNot publishedPull

The scope and webhook columns are checked against the spec's scope list and webhook data type list (read 11 Nov 2026). Most types are daily summaries. Heart rate is a time series. Each user consents to each data type, so any type can be missing for a given user.

What is inside one Oura sleep record

The sleep endpoint gives far more than a nightly score. These fields come from the spec's sleep model.

FieldWhat it holds
sleep_phase_5_minOne character per 5 minutes: 1 deep, 2 light, 3 REM, 4 awake
movement_30_secOne character per 30 seconds: no motion, restless, tossing and turning, or active
heart_rate and hrvSample series. Each has an interval field that gives the seconds between samples.
average_hrv, lowest_heart_rateNight values. Oura notes the API figures come from 30-second samples, while the app shows 5-minute aggregates, so they can differ from the app.
typeLong sleep, nap, late nap, rest or deleted. Only some types count toward daily scores.

Readiness adds temperature_deviation, which the spec defines only as a temperature deviation in degrees Celsius, plus contributor scores from 1 to 100 for body temperature, HRV balance and previous day activity. The heart rate series tags each sample with a source: awake, rest, sleep, workout, live or session. That is how you separate workout heart rate from resting heart rate.

What you cannot get

  • Any data for Gen3 and later users without an active Oura Membership. The API returns 403 and partner apps lose access.
  • Raw PPG, accelerometer or ECG data. None are in the endpoint list.
  • Writes. Every V2 usercollection path is read-only.
  • A published history window or numeric rate limits.
  • Fresh sleep data until the user opens the Oura app. Activity and stress may sync in the background.
  • Data types a user declined at consent.

How to get access

  1. Register an API Application at cloud.ouraring.com/oauth/applications. You get a Client ID and Client Secret.
  2. Build against the sandbox endpoints (/v2/sandbox/usercollection/...) if you have no rings yet.
  3. Connect up to 10 real users. "API Applications are limited to 10 users before requiring approval from Oura."
  4. When development is finished, request approval from your application's page. Oura approves. Criteria and wait time not published.
  5. After approval there is no user limit.
  6. For higher rate limits, email api-support@ouraring.com.

From zero to your first Oura data in four steps

  1. Register an app. Create an API Application at cloud.ouraring.com/oauth/applications and note the Client ID and Client Secret.
  2. Call the sandbox. The sandbox returns test data in the real shape, so you need no ring. Every request must send a User-Agent header.
    curl 'https://api.ouraring.com/v2/sandbox/usercollection/daily_activity?start_date=2021-11-01&end_date=2021-12-01' \
      --header 'Authorization: Bearer <token>' \
      --header 'User-Agent: YourAppName/1.0'
  3. Connect a real user. Send them to cloud.ouraring.com/oauth/authorize with only the scopes you need, for example daily, heartrate and spo2. Swap the code for tokens at api.ouraring.com/oauth/token on your server.
  4. Load history once, then listen. Oura's advice is one request for historical data when the user first connects, then webhooks for every update after that. Poll the heart rate series, since it has no webhook.

Terms you must know

From the Oura API agreement at cloud.ouraring.com/legal/api-agreement. The agreement now also covers an Oura MCP Server, and some clauses name it.

  • Storage, 3(m). "you shall not store or cache any data accessed or obtained through the MCP Server". Aggregators may not "store or cache any User Data or Oura Data". Healthcare: if the clause reaches API data, an EHR or trial database cannot keep Oura readings. Wellness: trend screens built on stored history are at risk too. Get counsel's read before design.
  • Deletion, 5(f). Act on deletion requests within 72 hours. Both readers: build a delete path across your database, backups and any EHR copy. In an EHR, a 72-hour delete can clash with record-keeping rules.
  • Competing products, 4(a)(ix) and (ii). No competing product and no purpose "competitive with Oura in any way". Healthcare: a sleep or readiness score of your own may be read as competing. Wellness: sleep apps face the same risk. Get Oura's view in writing.
  • Advertising, 4(a)(viii). No advertising or promoting Oura Data or User Data. Both readers: no ad targeting from Oura data.
  • Charging users, 4(a)(xiii). You may not charge users for access to the MCP Server or related services. Read it in full before you price a subscription.
  • Branding, 6(e). No Oura name or marks in your app name or icon.
  • Fees, 3(h). Oura may charge fees for the API in future.
  • Termination, 14(b) and 14(c). Either party may terminate at any time. Oura may suspend without notice. Healthcare: have a fallback in the protocol. Wellness: do not depend on Oura alone.
  • Medical use. No medical-device clause found. That does not make clinical use safe. FDA status of the ring is not in the developer docs.
  • PHI, HIPAA, BAA. Not mentioned. Ask Oura before PHI flows.
  • AI training and data selling. No specific clause in our research. Read the full agreement.

Cost and payment terms

  • Developer fee: none listed. Oura may charge in future (3(h)).
  • End user: an Oura Ring, plus an active Oura Membership for Gen3 and later. Membership price not confirmed on an Oura page in our research.
  • Higher rate limits: by email. No price published.
  • Aggregators: pricing not published.

Use cases

One night of Oura sleep data, from ring to your app.

Sleep coaching program

A member connects Oura in your app and approves the daily scope. When the member opens the Oura app in the morning, the ring syncs and Oura sends a webhook about 30 seconds later. Your server fetches the sleep periods and daily sleep score and shows the coach stage times, HRV and trends.

  • Member forgets to open the Oura app. Sleep data never arrives. Fix: a morning nudge, and a "last synced" indicator for the coach.
  • Membership lapses. 403 from the API. Fix: detect 403, tell the member, pause the program.
  • The storage clause may rule out long-term trend charts. Fix: get counsel's read before you design the history screen.

Remote monitoring pilot

A clinic enrolls patients who already own Oura rings. Daily SpO2, resting heart rate and respiratory rate from sleep feed a nurse dashboard. If the clinic wants values in the EHR, you map them to FHIR Observations, after legal sign-off on storage and PHI.

  • Patients without membership send nothing. Fix: check membership at enrollment.
  • Single-use refresh tokens break under retries. Fix: one refresh per user, saved before use.
  • 72-hour deletion versus EHR rules. Fix: decide with counsel which copy is yours to keep.

Employer or payer wellness

A member links Oura. A daily job reads activity and readiness summaries to check a reward goal. The result goes to the rewards system.

  • 10-user cap at launch. Fix: request approval before the rollout date.
  • Advertising ban. Fix: keep Oura data out of marketing lists.

Research study

Participants consent in the study app and connect Oura. Webhooks and a nightly pull collect sleep periods, heart rate time series and daily SpO2. Data lands in the study dataset under participant IDs.

  • Storage ban conflicts with study retention. Fix: Oura's written agreement before enrollment.
  • Rate limits on bulk heart rate pulls. Fix: read the X-RateLimit headers and back off on 429 using Retry-After.

Fitness or training app

A user connects Oura to see readiness next to their training plan. Workout and readiness webhooks update the plan screen.

  • Competing-product clause if you show your own readiness score. Fix: show Oura's score or get written approval.
  • Branding. Fix: keep Oura marks out of your app name and icon.

Oura data in an EHR or remote monitoring program

Most healthcare teams want Oura readings next to clinical data, not in a separate app. The usual pattern is to turn each reading into a FHIR Observation, the standard record for a measurement, and send it to the EHR or the remote monitoring platform. Read the storage clause first, because it decides whether you may keep the readings at all.

Oura valueFHIR ObservationCode
Heart rate sample (heartrate)Heart rate, beats per minuteLOINC 8867-4
Average SpO2 during sleep (daily_spo2)Oxygen saturation by pulse oximetry, percentLOINC 2708-6, plus 59408-5 for pulse oximetry
Total sleep time (sleep)Sleep durationLOINC 93832-4
HRV, readiness score, temperature deviationDevice-specific ObservationYour own code system. Oura does not say which HRV method it uses, and the scores are Oura's own, so no standard code fits exactly.

Keep the Oura record id on each Observation so a webhook update or a deletion can find it again. Oura's agreement asks for deletion requests within 72 hours, so build that path before launch.

Known blockers and gotchas

  • Membership gate. A 403 can mean the user's subscription expired. Show the user a message and pause their data, and do not page your on-call team.
  • Single-use refresh tokens. Refresh tokens rotate. Save the new one before you use the new access token, and never refresh twice in parallel.
  • Personal access tokens are gone. They were deprecated in December 2025. Any script that still uses one will fail. Move it to OAuth.
  • User-Agent header required. Every request must send one.
  • Webhook subscriptions need renewing. The API has a renew operation for subscriptions. Schedule renewals and alert when one fails.
  • Two rate limit layers. Per token and per application. Read the X-RateLimit-Limit, -Window, -Reset and -Tier headers.
  • Client-side flow has no refresh. Tokens last 30 days and then the user signs in again. Use the server flow for anything ongoing.
  • Agreement scope. The agreement now covers an MCP Server and some clauses name only it. Get counsel to read which apply to the REST API.

Delivery timeline

Our estimate. Steps marked "vendor" depend on Oura.

WeekWorkDepends on vendor?
1Register app, server OAuth with PKCE and rotating refresh, sandbox endpointsNo
2 to 3Endpoints, webhook subscriptions and renewal, 403 handling, deletion path, FHIR mappingNo
In parallelLegal review of storage, competing-product and MCP clausesNo, counsel
3 onwardApproval request to lift the 10-user capVendor, no published wait

Questions to ask Oura before you sign

  1. Does section 3(m) on storage apply to REST API data, or only to the MCP Server?
  2. Can we keep Oura readings in an EHR or study database, and for how long?
  3. Would our own score or dashboard count as competitive under 4(a)(ix)?
  4. Will you sign a BAA, or give written approval for PHI use?
  5. What do you check in approval, and how long does it take?
  6. What are our numeric rate limits?
  7. How far back does the API return history for a new user?
  8. Can an organization pay for members' Oura Membership so data keeps flowing?

Other device integration guides

Oura is often one device among several. Each guide below uses the same layout, so you can compare access, data and terms side by side. For the full service, see medical device integration.

Ready to build with Oura?

We build device integrations into healthcare and wellness products, including FHIR mapping and EHR delivery. We have no partnership with Oura. Tell us your device, your users and your target date, and we will send back the route, the vendor approvals you need and a build plan. Book a call about your device integration.

For whoever builds this

  • OAuth2. Authorize: https://cloud.ouraring.com/oauth/authorize. Token: https://api.ouraring.com/oauth/token. PKCE recommended (S256).
  • Server-side flow: lifetime from expires_in. Refresh tokens single-use and rotating. Client-side flow: 30-day token, no refresh.
  • Scopes: email, personal, daily, heartrate, workout, tag, session, spo2, heart_health.
  • Endpoints: /v2/usercollection/ daily_activity, daily_cardiovascular_age, daily_readiness, daily_resilience, daily_sleep, daily_spo2, daily_stress, enhanced_tag, heartrate, personal_info, rest_mode_period, ring_battery_level, ring_configuration, session, sleep, sleep_time, tag, vO2_max, workout. Sandbox mirror at /v2/sandbox/usercollection/.
  • Webhooks: /v2/webhook/subscription (create, list, renew, delete) with x-client-id and x-client-secret headers. Read the request body and signing details from the spec.
  • Required header: User-Agent.
  • Rate limits: per token and per app. 429 with Retry-After, X-RateLimit-Limit, -Window, -Reset, -Tier. Numbers not published.
  • Errors: 403 can mean expired membership.
  • FHIR (LOINC from the FHIR R4 vital signs profile): heart rate 8867-4, SpO2 2708-6, respiratory rate 9279-1, body weight 29463-7, body height 8302-2.
  • Unverified codes: sleep stages, HRV, VO2 max, cardiovascular age. Readiness and resilience are Oura scores and need a local code system.
  • Version: API 2.0, spec openapi-1.43. V1 removed 22 Jan 2024. PATs deprecated December 2025.

Sources

All read 10 Nov 2026.

  • Oura Apple Health integration, https://support.ouraring.com/hc/en-us/articles/360025438734-Apple-Health-Integration, read 10 November 2026.
  • Oura Health Connect integration, https://support.ouraring.com/hc/articles/10786105824531-Health-Connect-by-Android-Integration, read 10 November 2026.
  • Terra supported integrations, https://docs.tryterra.co/reference/health-and-fitness-api/supported-integrations, read 10 November 2026.
  • Junction providers list, https://docs.junction.com/wearables/providers/introduction, read 10 November 2026.
  • Thryve data sources overview, https://docs.thryve.health/thryve-data-sources/overview, read 10 November 2026.
  • ROOK data sources, https://docs.tryrook.io, read 10 November 2026.
  • Sahha integrations, https://www.sahha.ai/docs/connect/integrations.md, read 10 November 2026.
  • Spike integrations, https://www.spikeapi.com/integrations, read 10 November 2026.
  • Validic supported devices and restricted vendor list, https://www.validic.com/features/supported-devices/, read 10 November 2026.
  • https://cloud.ouraring.com/v2/docs
  • https://cloud.ouraring.com/v2/static/json/openapi-1.43.json
  • https://cloud.ouraring.com/docs/
  • https://cloud.ouraring.com/docs/authentication
  • https://cloud.ouraring.com/legal/api-agreement
  • https://support.ouraring.com/hc/en-us/articles/4415266939155-The-Oura-API
  • https://hl7.org/fhir/R4/observation-vitalsigns.html

Ready to scale?

Talk to our healthcare engineering team about building, integrating, and shipping faster.

Frequently Asked Questions

Does Oura have a public API?

Yes. The Oura API V2 is a REST API with OAuth2 and webhooks. Oura says it is the only available integration point for Oura data, and V1 was removed on 22 Jan 2024.

Is the Oura API free?

No developer fee is listed today. The API agreement, section 3(h), says Oura reserves the right to charge fees for the API in future.

Do Oura users need a membership for the API to work?

Yes for Gen3 and later rings. Oura's support page says users without an active Oura Membership cannot access their data through the API, and partner apps lose access to it. The API can return 403 when a subscription has expired.

How many users can connect to an Oura API app?

Up to 10 before approval. Oura says there is no limit once an application is approved. Approval criteria and wait times are not published.

What data can I get from the Oura API?

Daily activity, readiness, sleep score, sleep periods with stage durations and HRV, sleep time, SpO2, stress, resilience, cardiovascular age, VO2 max, heart rate time series, workouts, sessions, tags, rest mode, personal info and ring battery and configuration. Each user consents per scope.

Can I get raw sensor or ECG data from Oura?

No. Raw PPG, accelerometer and ECG data are not in the V2 endpoint list. Heart rate comes as a time series. Most other data comes as daily summaries.

Does the Oura API support webhooks?

Yes, and Oura calls them the preferred way. Notifications arrive about 30 seconds after the mobile app syncs. Subscriptions must be renewed, and the API has a renew operation for that.

Can I store Oura data in an EHR?

Check with counsel first. Section 3(m) of the API agreement says you shall not store or cache data obtained through the MCP Server, and aggregators may not store or cache User Data or Oura Data. Section 5(f) also requires deletion within 72 hours of a request.

Is the Oura API HIPAA compliant?

The API agreement does not mention HIPAA, and no BAA is published. Ask Oura in writing before you use the API with protected health information.

Are Oura personal access tokens still supported?

No. Personal access tokens were deprecated in December 2025 and are no longer available for use. Use OAuth2.

What are the Oura API rate limits?

Oura applies limits per access token and per application, and returns 429 with Retry-After and X-RateLimit headers. Numeric limits are not published. Email api-support@ouraring.com for higher limits.

Which OAuth scopes does the Oura API use?

Nine: email, personal, daily, heartrate, workout, tag, session, spo2 and heart_health. Daily covers sleep, activity and readiness summaries. Ask only for the scopes you use, since each user consents to each one.

How much history do I get when a user first connects?

Oura does not publish a history limit. Its advice is to make one request for historical data with start_date and end_date when the user connects, then rely on webhooks. Test the real depth on your own accounts before you promise a number.

Does the Oura API send heart rate by webhook?

No. Heart rate is not in the webhook data type list, so poll the heartrate endpoint. Sleep, readiness, activity, SpO2, stress, workouts and most other types do have webhooks.

What does Oura's temperature deviation mean?

The spec defines it as a temperature deviation in degrees Celsius. It is a change, not a body temperature reading, and Oura does not define the baseline in the API docs. It feeds the readiness score as a contributor scored from 1 to 100.

Can I get heart rate during workouts?

Yes. Each heart rate sample carries a source field, and workout is one of the values. Filter on it, or match the samples to the start and end times from the workout endpoint.

Which Oura API version should I use?

Version 2. V1 was removed on 22 January 2024, and personal access tokens were deprecated in December 2025, so new builds use V2 with OAuth2.
Share