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 the start date and the second date is the end date (inclusive). If you omit the start date, it will be set to one week ago. If you omit the end date, it will be set to the current 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 the start date and the second date is the end date (inclusive). If you omit the start date, it will be set to one week ago. If you omit the end date, it will be set to the current 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 the start date and the second date is the end date (inclusive). If you omit the start date, it will be set to one week ago. If you omit the end date, it will be set to the current day. See Readiness for documentation of available fields in the response.

Example Response

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