Skip to main content

Oura Sleep Time Export Format

  • Updated

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 string(id)
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"
}

Was this article helpful?