Connect with Oura

Terra's Oura web API integration will enable your application to unlock the power users' Oura data. Users' detailed sleep metrics will be available within your app - this will range from a detailed hypnogram through the user's sleep, to heart rate values sampled every 5 minutes, as well as data from Oura's proprietary readiness & sleep score calculation algorithms. You'll receive users' scores from 1 to 100 indicating their quality of sleep & their readiness for physicall stress.

Start Receiving Data From Oura In 5 Minutes

Oura

Enable Oura through your Terra dashboard

Select a Wearable

Oura

Connect

Connect users to your app

0. "active_durations_data":{...}
1. "calories_data": {...}
2. "device_data": {...}
3. "distance_data": {...}
4. "heart_rate_data": {...}
5. "movement_data": {...}
6. "position_data": {...}

Start receiving data from Oura on your app or website

You Can Receive...

Recent Data with Webhooks

Historical Data with HTTP Requests

When data is available from an Apple device, it will be streamed to you via our webhooks. During your Terra account setup, you'll be prompted to provide a callback URL, allowing Terra to PUSH data using POST requests.

You may also use HTTP requests with your Apple integration in case you wish to request historical data or data over extended periods of time.

Our Apple integration with Terra offers instant data delivery, eliminating the need for periodic requests. Apple notifies Terra whenever new data is available, and we then POST the normalized data to your webhook.

Most HTTP endpoints can take additional parameters start_date and end_date which allow you to request data over a specific period for the given user.

Oura's
Activity

Payload Preview

Oura's
Body

Payload Preview

Oura's
Daily

Payload Preview

Oura's
Sleep

Payload Preview

Terra API preserves the raw data from the wearable, it just standardizes the units and the json format. It doesn’t augment or change the raw data in any way.

Data is organized into one of 6 data types.

Learn More

Oura's Avaliable Data Types

Activity Payload (JSON)

{

metadata: { ... }

calories_data: { ... }

device_data: { ... }

distance_data: { ... }

heart_rate_data: { ... }

}

Data can also be sent as a FIT File or with the FHIR Format.