Skip to content

Single Daily Spo2 Document

GET
/v2/usercollection/daily_spo2/{document_id}
curl --location --request GET 'https://api.ouraring.com/v2/usercollection/daily_spo2/2-5daccc095220cc5493a4e9c2b681ca941e' \
--header 'Authorization: Bearer <token>'
document_id
required
Document Id
string

Successful Response

Media typeapplication/json
PublicDailySpO2

Daily SpO2 (Oxygen saturation).

object
id
required

Unique identifier of the object.

string
>= 1 characters
breathing_disturbance_index
Any of:
integer
day
required

Day that the spo2 values belong to.

string
spo2_percentage
Any of:
PublicSpo2AggregatedValues

Object defining public spo2 aggregated values.

object
average
required

Average of spo2.

number
Examplegenerated
{
"id": "example",
"breathing_disturbance_index": 1,
"day": "example",
"spo2_percentage": {
"average": 1
}
}

Client Exception

Unauthorized access exception. Usually means the access token is expired, malformed or revoked.

Access forbidden. Usually means the user’s subscription to Oura has expired and their data is not available via the API.

Not Found

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}

Request Rate Limit Exceeded.