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

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

HealthConnectRecordKey

A unique key for this Health Connect Record, used to cross reference Stages in CSV format.

ParticipantIdentifier

The identifier of the participant this record is for. Can be used to cross reference with Participants.

ParticipantID

The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).

MetadataOriginPackageName

The package name of the application that generated this record.

MetadataLastModifiedTime

When the data was last modified (or originally created) by the application, in ISO 8601 format. Is always in UTC.

MetadataClientRecordID

Optional client-supplied record unique data identifier associated with this record.

MetadataClientRecordVersion

Optional client-supplied version associated with this record.

MetadataDeviceManufacturer

Optional client-supplied manufacturer of the device associated with this record.

MetadataDeviceModel

Optional client-supplied model of the device associated with this record.

MetadataDeviceType

Optional client-supplied manufacturer of the device associated with this record.

MetadataRecordingMethod

Whether the record was generated manually or automatically, if known.

InsertedDate

The date MyDataHelps received the data from Health Connect, in ISO 8601 format. Is always in UTC.

StartTime

The time the record started, in ISO 8601 format.

Note: In Records includes timezone offset information, in Stages is always in UTC.

StartZoneOffsetSetAtUpload

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.

EndTime

The time the record ended, in ISO 8601 format.

NOTE: In Records includes timezone offset information, in Stages is always in UTC.

EndZoneOffsetSetAtUpload

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.

Title

Optional title of the sleep record

Notes

Optional notes for this sleep record.

Stage

The sleep stage during this interval. Stages are:

  • `"STAGE_TYPE_AWAKE"`
  • `"STAGE_TYPE_AWAKE_IN_BED"`
  • `"STAGE_TYPE_DEEP"`
  • `"STAGE_TYPE_LIGHT"`
  • `"STAGE_TYPE_OUT_OF_BED"`
  • `"STAGE_TYPE_REM"`
  • `"STAGE_TYPE_SLEEPING"`
  • `"STAGE_TYPE_UNKNOWN"`

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"
  }
  ]
}