Skip to content
Contact us
  • There are no suggestions because the search field is empty.

Oura Enhanced Tag Export Format

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.

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

  • 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 A unique string identifier assigned to each data entry, received from Oura.
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 TagTypeCode 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": ""
}