Oura: New Metrics Added

As of June 11, 2024, the following Inform API metrics will be populated when users grant access to the required scopes and data is provided by Oura. This data will appear in the resources listed below when captured by the Oura integration.

Inform Metric	Resource	Data Type	Standard Unit	Required Oura Scope(s)
avg_spo2	summaries	float	percent	"Sleep, Readiness and Activity Data", "SpO2 Data"
body_temperature_deviation	summaries	float	C	"Sleep, Readiness and Activity Data"
distance	workouts	float	m	"Workout Data"
energy_burned	workouts	float	kCal	"Workout Data"
workout_duration	workouts	float	s	"Workout Data"
avg_heart_rate	sleep	integer	bpm	"Sleep, Readiness and Activity Data", "Heart Rate Data"
awake_duration	sleep	float	s	"Sleep, Readiness and Activity Data"
deep_sleep	sleep	float	s	"Sleep, Readiness and Activity Data"
heart_rate_variability	sleep	float	ms	"Sleep, Readiness and Activity Data"
in_bed_duration	sleep	float	s	"Sleep, Readiness and Activity Data"
light_sleep	sleep	float	s	"Sleep, Readiness and Activity Data"
min_heart_rate	sleep	integer	bpm	"Sleep, Readiness and Activity Data", "Heart Rate Data"
rem_sleep	sleep	float	s	"Sleep, Readiness and Activity Data"
respiratory_rate	sleep	float	--	"Sleep, Readiness and Activity Data"
restless_count	sleep	integer	count	"Sleep, Readiness and Activity Data"
sleep_duration	sleep	float	s	"Sleep, Readiness and Activity Data"
sleep_score	sleep	float	percent	"Sleep, Readiness and Activity Data"
time_to_fall_asleep	sleep	float	s	"Sleep, Readiness and Activity Data"

In the Validic Inform marketplace, Oura users have been prompted to provide all available Oura scopes. That behavior remains the same so some users may have already granted the scopes needed to retrieve this data.

Any users who are already connected to Oura will not be notified of any changes. If a connected user did not previously grant the needed permissions, then they must disconnect and reconnect to Oura if they want to share this new data with you. During Oura OAuth, users must grant access to the scopes listed in the table above before these new data points will be available to you in the Inform API.

Additionally, category mappings have been added for Oura workouts, as follows:

Oura Activity	Validic Category
Walking	walking
Cycling	biking
Running	running
Housework	other
Yardwork	other
Strength training	strength
Hiking	walking
Swimming	swimming
Tennis	cardio
Cross-country skiing	cardio
Elliptical	cardio
Dance	cardio
Golf	cardio
HIIT	cardio
Soccer	cardio
Cross-training	cardio
Yoga	other
Surfing	other
Basketball	cardio
Boxing	cardio

An example excerpt of an Oura workouts record is shown below:

{
  "type":"workout",
...
  {
  "type":"workout",
  "name":"walking",
  "category":"walking",
  "start_time":"2023-01-14T14:14:00+00:00",
  "end_time":"2023-01-14T14:34:00+00:00",
  "origin_offset":"source",
  "source":{
    "type":"oura",
    "device":null
  },
  "metrics":[
    {
      "type":"energy_burned",
      "value": 63.98,
      "unit":"kcal",
      "origin":"device"
    },
    {
      "type":"distance",
      "value": 8,
      "unit":"m",
      "origin":"device"
    }
    {
      "type":"workout_duration",
      "value": 1200,
      "unit":"s",
      "origin":"device"
    },
  ],
  ....
}

An example excerpt of an Oura sleep record is shown below:

{
  "type":"sleep",
...
  "metrics": [
    {
      "type":"avg_heart_rate",
      "value": 68.5,
      "unit":"bpm",
      "origin":"device"
     },
     {
      "type":"awake_duration",
      "value": 6120,
      "unit":"s",
      "origin":"device"
     },
    {
      "type":"deep_sleep",
      "value": 2130,
      "unit":"s",
      "origin":"device"
     },
     {
      "type":"sleep_score",
      "value": 79,
      "unit":"percent",
      "origin":"device"
     },
    {
      "type":"time_to_fall_asleep",
      "value": 930,
      "unit":"s",
      "origin":"device"
     },
     {
      "type":"light_sleep",
      "value": 14250,
      "unit":"s",
      "origin":"device"
     },
    {
      "type":"min_heart_rate",
      "value": 55,
      "unit":"bpm",
      "origin":"device"
     },
     {
      "type":"rem_sleep",
      "value": 6900,
      "unit":"s",
      "origin":"device"
     },
    {
      "type":"restless_count",
      "value": 247,
      "unit":"count",
      "origin":"device"
     },
     {
      "type":"in_bed_duration",
      "value": 29400,
      "unit":"s",
      "origin":"device"
     },
    {
      "type":"sleep_duration",
      "value": 23280,
      "unit":"s",
      "origin":"device"
     }
  ]
}