Multiple Session Documents
curl --location --request GET 'https://api.ouraring.com/v2/usercollection/session?start_date=2021-11-01&end_date=2021-12-01&fields=day,score' \--header 'Authorization: Bearer <token>'import requestsurl = 'https://api.ouraring.com/v2/usercollection/session'params={ 'start_date': '2021-11-01', 'end_date': '2021-12-01', 'fields': 'day,score'}headers = { 'Authorization': 'Bearer <token>'}response = requests.request('GET', url, headers=headers, params=params)print(response.text)var myHeaders = new Headers();myHeaders.append('Authorization', 'Bearer <token>');var requestOptions = { method: 'GET', headers: myHeaders,};fetch('https://api.ouraring.com/v2/usercollection/session?start_date=2021-11-01&end_date=2021-12-01&fields=day,score', requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));OkHttpClient client = new OkHttpClient().newBuilder() .build();Request request = new Request.Builder() .url("https://api.ouraring.com/v2/usercollection/session?start_date=2021-11-01&end_date=2021-12-01&fields=day,score") .method("GET", null) .addHeader("Authorization", "Bearer <token>") .build();Response response = client.newCall(request).execute();Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Responses
Section titled “Responses”Successful Response
object
Public model defining a recorded Session.
object
Unique identifier of the object.
The date when the session occurred.
Timestamp indicating when the Moment ended.
Object defining a recorded sample.
object
Interval in seconds between the sampled items.
Recorded sample items.
Timestamp when the sample recording started.
Object defining a recorded sample.
object
Interval in seconds between the sampled items.
Recorded sample items.
Timestamp when the sample recording started.
Possible Moment moods.
Object defining a recorded sample.
object
Interval in seconds between the sampled items.
Recorded sample items.
Timestamp when the sample recording started.
Timestamp indicating when the Moment started.
Type of the Moment.
Example
{ "data": [ { "mood": "bad", "type": "breathing" } ]}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.
Validation Error
object
object
Examplegenerated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}Request Rate Limit Exceeded.