API Documentation

Daily Summaries

Oura Cloud API v1 provides data in daily summaries. There are 3 types of summaries: Sleep, Activity and Readiness. For a single day, there can be several sleep periods and readiness summaries, but only one activity summary.

Sleep Periods

https://api.ouraring.com/v1/sleep?start=YYYY-MM-DD&end=YYYY-MM-DD

The first date is a start date and the second date is an end date. You can leave out the end date, in that case you get data for a single day. See Sleep for documentation of available fields in the response

Example Response

  {
    "sleep": [{"summary_date": "2016-10-11", ...}, {"summary_date": "2016-10-12", ...}, ...]
  }

Activity Summaries

https://api.ouraring.com/v1/activity?start=YYYY-MM-DD&end=YYYY-MM-DD

The first date is a start date and the second date is an end date. You can leave out the end date, in that case you get data for a single day. See Activity for documentation of available fields in the response.

Example Response

  {
     "activity": [{"summary_date": "2016-10-11", ...}, {"summary_date": "2016-10-12", ...}, ...]
  }

Readiness Summaries

https://api.ouraring.com/v1/readiness?start=YYYY-MM-DD&end=YYYY-MM-DD

The first date is a start date and the second date is an end date. You can leave out the end date, in that case you get data for a single day. See Readiness for documentation of available fields in the response.

Example Response

  {
     "readiness": [{"summary_date": "2016-10-11", ...}, {"summary_date": "2016-10-12", ...}, ...]
  }