Oura Session Export Format

The Oura Session Export contains information on how users engage with guided and unguided sessions in the Oura app, including the wearer's biometric trends during the sessions.

File Prefix: OuraSession
Heart Rate File Prefix (CSV Format Only): OuraSessionHeartRate
Hrv File Prefix (CSV Format Only): OuraSessionHeartRateVariability
Motion Count File Prefix (CSV Format Only): OuraSessionMotionCount

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

Data Fields

Field	Description
`SessionKey`	The unique key for this session record, formatted as `ParticipantID_ID`. Used to reference heart rate, hrv, and motion count values to their parent activity record in CSV format export.
`ParticipantID`	The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
`ParticipantIdentifier`	The identifier of the participant this session 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`	The date when the session occurred, in YYYY-MM-DD format.
`StartDatetime`	Timestamp indicating when the Moment started, in ISO 8601 format.
`EndDatetime`	Timestamp indicating when the Moment ended, in ISO 8601 format.
`Type`	The type of moment this session represents. One of the following values: `"breathing"` `"meditation"` `"nap"` `"relaxation"` `"rest"` `"body_status"`
`Mood`	The wearer's mood during the moment, if provided. Possible values are `"bad"`, `"worse"`, `"same"`, `"good"`, and `"great"`.
`HeartRate`	An object containing heart rate samples recorded during the session, expressed in beats per minute. In JSON format only.
`Interval`	Interval between the samples, in seconds. In JSON format only.
`Items`	The wearer's heart rate, in beats per minute, at the specified `HeartRateInterval` during the session, in JSON format only.
`Timestamp`	Timestamp when the recording started, in JSON format only, in ISO 8601 format.
`HeartRateVariability`	An object containing heart rate variability samples recorded during the session, in JSON format only.
`MotionCount`	An object containing samples of the wearer's motion during the session, in JSON format only.
`ParentKey`	The parent SessionKey this item belongs to, in CSV format only.
`StartDateTime`	The start date and time of this heart rate, hrv, or motion count item recording, in in ISO 8601 format, in CSV format only.
`EndDateTime`	The end date and time of this heart rate, hrv, or motion count item recording, in in ISO 8601 format, in CSV format only.
`Value`	The recorded sample heart rate, hrv, or motion count item, in CSV format only.

Sample CSV Export

Oura Session

SessionKey,ParticipantID,ParticipantIdentifier,InsertedDate,ID,Day,StartDatetime,EndDatetime,Type,Mood
6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:07Z,4886e016-341c-45c4-9825-36086c7ab2a1,2025-02-06,2025-02-06T13:51:13-05:00,2025-02-06T13:53:38-05:00,breathing,same
6e2626f8-e891-ed11-98ad-f4ce23710c45_73a95c49-7481-4d7b-9fc5-bf9538c9ab28,6e2626f8-e891-ed11-98ad-f4ce23710c45,46ce54ac-e891-ed11-98ad-f4ce23710c45,2025-03-13T23:12:07Z,73a95c49-7481-4d7b-9fc5-bf9538c9ab28,2025-02-06,2025-02-06T13:54:08-05:00,2025-02-06T13:55:58-05:00,breathing,good

Oura Session Heart Rate

ParentKey,StartDateTime,EndDateTime,Value
6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1,2025-02-06T13:51:13-05:00,2025-02-06T13:51:18-05:00,64.4
6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1,2025-02-06T13:51:18-05:00,2025-02-06T13:51:23-05:00,64.3
6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1,2025-02-06T13:51:23-05:00,2025-02-06T13:51:28-05:00,64.3

Oura Session Hrv

ParentKey,StartDateTime,EndDateTime,Value

Oura Session Motion Count

ParentKey,StartDateTime,EndDateTime,Value
6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1,2025-02-06T13:51:13-05:00,2025-02-06T13:51:18-05:00,0
6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1,2025-02-06T13:51:18-05:00,2025-02-06T13:51:23-05:00,0
6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1,2025-02-06T13:51:23-05:00,2025-02-06T13:51:28-05:00,0

Sample JSON Export

{
    "SessionKey": "6e2626f8-e891-ed11-98ad-f4ce23710c45_4886e016-341c-45c4-9825-36086c7ab2a1",
    "ParticipantID": "6e2626f8-e891-ed11-98ad-f4ce23710c45",
    "ParticipantIdentifier": "46ce54ac-e891-ed11-98ad-f4ce23710c45",
    "InsertedDate": "2025-03-13T23:12:07Z",
    "ID": "4886e016-341c-45c4-9825-36086c7ab2a1",
    "Day": "2025-02-06",
    "StartDatetime": "2025-02-06T13:51:13-05:00",
    "EndDatetime": "2025-02-06T13:53:38-05:00",
    "Type": "breathing",
    "HeartRate": {
        "Interval": 5.0,
        "Items": [
            null, null, null, null, null, 64.4, 64.3, 64.3, 64.2, 64.1, 
            64.0, 63.9, 63.9, 63.8, 63.8, 63.7, 63.6, 63.5, 63.4, 63.3, 
            63.1, 63.0, 62.9, 62.8, 62.8, 62.7, 62.7, 62.6, 62.6
        ],
        "Timestamp": "2025-02-06T13:51:13-05:00"
    },
    "HeartRateVariability": {
        "Interval": 5.0,
        "Items": [
            null, null, null, null, null, null, null, null, null, null, 
            null, null, null, null, null, null, null, null, null, null, 
            null, null, null, null, null, null, null, null, null
        ],
        "Timestamp": "2025-02-06T13:51:13-05:00"
    },
    "Mood": "same",
    "MotionCount": {
        "Interval": 5.0,
        "Items": [
            0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 3.0, 2.0, 0.0, 6.0, 
            2.0, 0.0, 0.0, 1.0, 1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 
            0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0
        ],
        "Timestamp": "2025-02-06T13:51:13-05:00"
    }
}