Skip to main content

Oura Daily Sleep Export Format

  • Updated

The Oura Daily Readiness Export contains information about the sleep period. A sleep period is a nearly continuous, longish period of time spent lying down in bed. 

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

Data Fields

Field Description
DailySleepKey The unique key for this daily sleep 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 this 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

Day that the daily sleep belongs to, in YYYY-MM-DD format.
Score

Daily sleep score.
Timestamp

Timestamp of the daily sleep, in ISO 8601 format.
ContributorsDeepSleep

Contribution of deep sleep in range [1, 100].
ContributorsEfficiency

Contribution of sleep efficiency in range [1, 100].
ContributorsLatency

Contribution of sleep latency in range [1, 100].
ContributorsRemSleep

Contribution of REM sleep in range [1, 100].
ContributorsRestfulness

Contribution of sleep restfulness in range [1, 100].
ContributorsTotalSleep

Contribution of total sleep in range [1, 100].

Sample CSV Export

DailySleepKey,ParticipantID,ParticipantIdentifier,InsertedDate,ID,Day,Score,Timestamp,ContributorsDeepSleep,ContributorsEfficiency,ContributorsLatency,ContributorsRemSleep,ContributorsRestfulness,ContributorsTiming,ContributorsTotalSleep
6e2626f8-e891-ed11-98ad-f4ce23710c45_ba26a5c9-2be8-4ca4-a458-1b8d7b71b53d,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:11:58Z,ba26a5c9-2be8-4ca4-a458-1b8d7b71b53d,2025-02-01,72,2025-02-01T00:00:00+00:00,70,83,19,84,86,83,73
6e2626f8-e891-ed11-98ad-f4ce23710c45_df42fb09-8c41-49af-acd8-74560ad796ef,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:11:58Z,df42fb09-8c41-49af-acd8-74560ad796ef,2025-02-02,66,2025-02-02T00:00:00+00:00,5,41,89,66,78,100,69
6e2626f8-e891-ed11-98ad-f4ce23710c45_38f0dba6-4346-40fa-b5b6-209ea6e0df56,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:11:58Z,38f0dba6-4346-40fa-b5b6-209ea6e0df56,2025-02-03,69,2025-02-03T00:00:00+00:00,68,76,18,65,82,93,71

Sample JSON Export

{
  "DailySleepKey": "6e2626f8-e891-ed11-98ad-f4ce23710c45_ba26a5c9-2be8-4ca4-a458-1b8d7b71b53d",
  "ParticipantID": "6e2626f8-e891-ed11-98ad-f4ce23710c45",
  "ParticipantIdentifier": "46ce54ac-e891-ed11-98ad-f4ce23710c45",
  "InsertedDate": "2025-03-13T23:11:58Z",
  "ID": "ba26a5c9-2be8-4ca4-a458-1b8d7b71b53d",
  "Day": "2025-02-01",
  "Score": 72,
  "Timestamp": "2025-02-01T00:00:00+00:00",
  "Contributors": {
    "DeepSleep": 70,
    "Efficiency": 83,
    "Latency": 19,
    "RemSleep": 84,
    "Restfulness": 86,
    "Timing": 83,
    "TotalSleep": 73
  }

Was this article helpful?