Health Connect Sleep Records Export Format
The Sleep Records export contains data about users' sleep sessions. Each record represents a time interval for a full sleep session, and the stages within.
- File Prefix: `HealthConnectRecords_Sleep`
- Stages File Prefix (CSV Format): `HealthConnectRecords_Sleep_Stages`
Data Fields
|
Field |
Description |
|---|---|
|
|
A unique key for this Health Connect Record, used to cross reference Stages in CSV format. |
|
|
The identifier of the participant this record is for. Can be used to cross reference with Participants. |
|
|
The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID). |
|
|
The package name of the application that generated this record. |
|
|
When the data was last modified (or originally created) by the application, in ISO 8601 format. Is always in UTC. |
|
|
Optional client-supplied record unique data identifier associated with this record. |
|
|
Optional client-supplied version associated with this record. |
|
|
Optional client-supplied manufacturer of the device associated with this record. |
|
|
Optional client-supplied model of the device associated with this record. |
|
|
Optional client-supplied manufacturer of the device associated with this record. |
|
|
Whether the record was generated manually or automatically, if known. |
|
|
The date MyDataHelps received the data from Health Connect, in ISO 8601 format. Is always in UTC. |
|
|
The time the record started, in ISO 8601 format. Note: In Records includes timezone offset information, in Stages is always in UTC. |
|
|
Whether the time zone offset applied to `StartTime` was derived from the mobile device's zone offset when the data was uploaded. "True" if derived in this way, "False", Null (CSV) or missing property (JSON) if zone offset was provided by Health Connect. |
|
|
The time the record ended, in ISO 8601 format. NOTE: In Records includes timezone offset information, in Stages is always in UTC. |
|
|
Whether the time zone offset applied to `EndTime` was derived from the mobile device's zone offset when the data was uploaded. "True" if derived in this way, "False", Null (CSV) or missing property (JSON) if zone offset was provided by Health Connect. |
|
|
Optional title of the sleep record |
|
|
Optional notes for this sleep record. |
|
|
The sleep stage during this interval. Stages are:
|
Sample CSV Export
Sleep Records
HealthConnectRecordKey,ParticipantIdentifier,ParticipantID,MetadataDataOriginPackageName,MetadataLastModifiedTime,MetadataClientRecordID,MetadataClientRecordVersion,MetadataDeviceManufacturer,MetadataDeviceModel,MetadataDeviceType,MetadataRecordingMethod,InsertedDate,StartTime,StartZoneOffsetSetAtUpload,EndTime,EndZoneOffsetSetAtUpload,Title,Notes
76dde514-4926-3484-aee4-1fc915993936,TST123456,1be320d5-57fa-4860-8fa2-033b27038c4e,com.garmin.android.apps.connectmobile,2026-03-21T11:04:45.437Z,1774065600000,1,,,TYPE_WATCH,RECORDING_METHOD_AUTOMATICALLY_RECORDED,2026-04-01T13:09:38Z,2026-03-20T23:26:16.000-04:00,,2026-03-21T06:59:37.000-04:00,,a title,a note
Sleep Stages
HealthConnectRecordKey,StartTime,EndTime,Stage
76dde514-4926-3484-aee4-1fc915993936,2026-03-21T04:08:55Z,2026-03-20T04:31:55Z,STAGE_TYPE_DEEP
76dde514-4926-3484-aee4-1fc915993936,2026-03-21T04:31:55Z,2026-03-20T05:14:55Z,STAGE_TYPE_LIGHT
76dde514-4926-3484-aee4-1fc915993936,2026-03-21T05:14:55Z,2026-03-20T05:42:55Z,STAGE_TYPE_REM
Sample JSON Export
{
"HealthConnectRecordKey": "76dde514-4926-3484-aee4-1fc915993936",
"ParticipantIdentifier": "TST123456",
"ParticipantID": "1be320d5-57fa-4860-8fa2-033b27038c4e",
"InsertedDate": "2026-03-21T13:09:38Z",
"Metadata": {
"DataOriginPackageName": "com.garmin.android.apps.connectmobile",
"LastModifiedTime": "2026-03-21T11:04:45.437Z",
"ClientRecordID": "1774065600000",
"ClientRecordVersion": 1,
"Device": { "Type": "TYPE_WATCH" },
"RecordingMethod": "RECORDING_METHOD_AUTOMATICALLY_RECORDED"
},
"StartTime": "2026-03-20T23:26:16.000-04:00",
"EndTime": "2026-03-21T06:59:37.000-04:00",
"Stages": [
{
"StartTime": "2026-03-21T04:08:55Z",
"EndTime": "2026-03-20T04:31:55Z",
"Stage": "STAGE_TYPE_DEEP"
},
{
"StartTime": "2026-03-21T04:31:55Z",
"EndTime": "2026-03-20T05:14:55Z",
"Stage": "STAGE_TYPE_LIGHT"
},
{
"StartTime": "2026-03-21T05:14:55Z",
"EndTime": "2026-03-20T05:42:55Z",
"Stage": "STAGE_TYPE_REM"
}
]
}