Skip to main content

Oura Enhanced Tag Export Format

  • Updated

The Oura Enhanced Tag Export contains tags that Oura wearers enter within the Oura mobile app. Enhanced Tags can be added for any lifestyle choice, habit, mood change, or environmental factor an Oura user wants to monitor the effects of. Enhanced Tags also contain context on a tag's start and end time, whether a tag repeats daily, and comments.

[note]Exports will appear empty if a wearer does not enter a tag within the Oura mobile app. [/note]

  • File Prefix: `OuraEnhancedTag`

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

Data Fields

Field Description
EnhancedTagKey The unique key for this enhanced key 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 enhanced tag 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)
TagTypeCode

The unique code of the selected tag type, either  `NULL` for text-only tags, or `custom` for custom tag types.
StartTime

Timestamp of the tag (if no duration) or the start time of the tag (with duration), in ISO 8601 format.
EndTime Timestamp of the tag's end for events with duration, in ISO 8601 format, or NULL if there is no duration.
StartDay Day of the tag (if no duration) or the start day of the tag (with duration), in YYYY-MM-DD format.
EndDay Day of the tag's end for events with duration, in YYYY-MM-DD format, or NULL if there is no duration.
Comment

Additional freeform text on the tag.
CustomName

The name of the tag if the tag_type_code is custom.

Sample CSV Export

EnhancedTagKey,ParticipantID,ParticipantIdentifier,InsertedDate,ID,TagTypeCode,StartTime,EndTime,StartDay,EndDay,Comment,CustomName
a466ec83-9092-45be-b11a-0f3baf76fc3c_93f575b2-4b2f-4b1f-9aa6-d9992ad42874,a466ec83-9092-45be-b11a-0f3baf76fc3c,271981b0-9504-4a8f-9d36-a2c2022a1f2f,2025-03-10T17:58:38Z,93f575b2-4b2f-4b1f-9aa6-d9992ad42874,tag_sleep_alcohol,2024-08-09T21:58:27+03:00,,2024-08-09,,,
a466ec83-9092-45be-b11a-0f3baf76fc3c_c7c00865-6569-468e-89f8-ac8a11d365d7,a466ec83-9092-45be-b11a-0f3baf76fc3c,271981b0-9504-4a8f-9d36-a2c2022a1f2f,2025-03-10T17:58:38Z,c7c00865-6569-468e-89f8-ac8a11d365d7,tag_sleep_stress,2024-09-02T01:04:32-04:00,,2024-09-02,,,
a466ec83-9092-45be-b11a-0f3baf76fc3c_b7eaf91d-f036-499f-989c-3e7cf0be8dce,a466ec83-9092-45be-b11a-0f3baf76fc3c,271981b0-9504-4a8f-9d36-a2c2022a1f2f,2025-03-10T17:58:38Z,b7eaf91d-f036-499f-989c-3e7cf0be8dce,tag_sleep_alcohol,2024-09-21T00:32:30-04:00,,2024-09-21,,,

Sample JSON Export

{
    "EnhancedTagKey": "a466ec83-9092-45be-b11a-0f3baf76fc3c_93f575b2-4b2f-4b1f-9aa6-d9992ad42874",
    "ParticipantID": "a466ec83-9092-45be-b11a-0f3baf76fc3c",
    "ParticipantIdentifier": "271981b0-9504-4a8f-9d36-a2c2022a1f2f",
    "InsertedDate": "2025-03-10T17:58:38Z",
    "ID": "93f575b2-4b2f-4b1f-9aa6-d9992ad42874",
    "TagTypeCode": "tag_sleep_alcohol",
    "StartTime": "2024-08-09T21:58:27+03:00",
    "StartDay": "2024-08-09",
    "Comment": ""
}

Was this article helpful?