Oura Session Export Format
- Updated
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 |
string(id) |
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:
|
HeartRateInterval |
Interval in seconds between the heart rate samples, in JSON format only. |
HeartRateItems |
The wearer's heart rate, in beats per minute, at the specified `HeartRateInterval` during the session, in JSON format only. |
HeartRateTimestamp |
Timestamp when the heart rate recording started, in JSON format only, in ISO 8601 format. |
HeartRateVariabilityInterval |
Interval in seconds between the heart rate variability records, in JSON format only. |
HeartRateVariabilityItems |
The wearer's heart rate variability, at the specified `HeartRateVariabilityInterval` during the session, in JSON format only. |
HeartRateVariabilityTimestamp |
Timestamp when the heart rate variability sample recording started, in JSON format only, in ISO 8601 format. |
Mood |
The wearer's mood during the moment, if provided. Possible values are `"bad"`, `"worse"`, `"same"`, `"good"`, and `"great"`. |
MotionCountInterval |
Interval in seconds between the motion records, in JSON format only. |
MotionCountItems |
The wearer's motion, at the specified `MotionInterval` during the session, in JSON format only. |
MotionCountTimestamp |
Timestamp when the motion recording started, in JSON format only, in ISO 8601 format. |
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"
}
}
Was this article helpful?