Skip to content
Contact us
  • There are no suggestions because the search field is empty.

Oura Sleep Time Export Format

The Oura Sleep Time Export contains recommendations for the optimal bedtime window that is calculated based on sleep data.

  • File Prefix: OuraSleepTime

For a complete list of all the export file types possible, see the Oura Export Overview.

Data Fields

Field Description
SleepTimeKey The unique key for this sleep time record, formatted as ParticipantID_ID.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
ParticipantIdentifier The identifier of the participant the sleep time record is for. Can be used to cross reference with Participants.
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.
ID A unique string identifier assigned to each data entry, received from Oura.
Day

Corresponding day for the sleep time, in YYYY-MM-DD format.
OptimalBedtimeDayTz

Timezone offset in second from GMT of the day.
OptimalBedtimeEndOffset

End offset from midnight in seconds.
OptimalBedtimeStartOffset

Start offset from midnight in seconds.
Recommendation

The wearer's recommended action for bedtime, if provided. Could be any of the following: "improve_efficiency", "earlier_bedtime", "later_bedtime",
"earlier_wake_up_time", "later_wake_up_time",
"follow_optimal_bedtime".
Status

Sleep time status; used to inform sleep time recommendation. Could be any of the following: "not_enough_nights", "not_enough_recent_nights",
"bad_sleep_quality", "only_recommended_found", "optimal_found".

 

Sample CSV Export

SleepTimeKey,ParticipantID,ParticipantIdentifier,InsertedDate,ID,Day,OptimalBedtimeDayTz,OptimalBedtimeEndOffset,OptimalBedtimeStartOffset,Recommendation,Status
6e2626f8-e891-ed11-98ad-f4ce23710c45_1bc35927-aa46-4274-99c2-6202f178f22c,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:08Z,1bc35927-aa46-4274-99c2-6202f178f22c,2025-02-02,,,,improve_efficiency,bad_sleep_quality
6e2626f8-e891-ed11-98ad-f4ce23710c45_f8ef417b-fe91-4b77-b0c3-87167d6790ca,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:08Z,f8ef417b-fe91-4b77-b0c3-87167d6790ca,2025-02-03,,,,improve_efficiency,bad_sleep_quality
6e2626f8-e891-ed11-98ad-f4ce23710c45_d14c56d7-77c3-460c-93ac-3be976477e6d,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:08Z,d14c56d7-77c3-460c-93ac-3be976477e6d,2025-02-04,,,,improve_efficiency,bad_sleep_quality

 

Sample JSON Export

{
    "SleepTimeKey": "6e2626f8-e891-ed11-98ad-f4ce23710c45_1bc35927-aa46-4274-99c2-6202f178f22c",
    "ParticipantID": "6e2626f8-e891-ed11-98ad-f4ce23710c45",
    "ParticipantIdentifier": "46ce54ac-e891-ed11-98ad-f4ce23710c45",
    "InsertedDate": "2025-03-13T23:12:08Z",
    "ID": "1bc35927-aa46-4274-99c2-6202f178f22c",
    "Day": "2025-02-02",
    "Recommendation": "improve_efficiency",
    "Status": "bad_sleep_quality"
}