Google Health Sleep Export Format
The Google Health Sleep export contains sleep sessions reported through Google Health, including each session's sleep stages and out-of-bed segments. Respiratory rate observed during a sleep session is exported separately—see Google Health Sleep Respiratory Rate Export Format.
Deleted sleep session records are described in GoogleHealthSleep_Deleted. See Google Health Deleted Export Format for the full field reference and how to apply it.
Data Fields
Sleep
| Field | Description |
|---|---|
GoogleHealthSleepKey |
Unique key for this sleep session. |
ParticipantIdentifier |
The identifier of the participant this entry was recorded for. Can be used to cross reference with Participants. |
StartDate |
Session start time in ISO 8601 format, includes timezone offset information. |
EndDate |
Session end time in ISO 8601 format, includes timezone offset information. |
ParticipantID |
The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID). |
ModifiedDate |
When this record was last modified, in ISO 8601 format. Is always in UTC. |
SessionId |
Google's data point name for this session (e.g., users/…/dataTypes/sleep/dataPoints/…). |
Type |
The determined type of this sleep session type, e.g., "STAGES" or "CLASSIC". |
MinutesInSleepPeriod |
Total minutes in the sleep period. |
MinutesAfterWakeUp |
Minutes spent awake after the participant's final wake-up, before the sleep record ends. |
MinutesToFallAsleep |
Minutes it took the participant to fall asleep. |
MinutesAsleep |
Total minutes asleep. |
MinutesAwake |
Total minutes awake during the sleep period. |
StagesSummaryAwakeMinutes |
Total minutes spent in the awake stage segments. |
StagesSummaryAwakeCount |
Number of distinct Awake sleep stage segments. |
StagesSummaryLightMinutes |
Total minutes spent in light sleep stage segments. |
StagesSummaryLightCount |
Number of distinct Light sleep stage segments. |
StagesSummaryDeepMinutes |
Total minutes spent in deep sleep stage segments. |
StagesSummaryDeepCount |
Number of distinct Deep sleep stage segments. |
StagesSummaryRemMinutes |
Total minutes spent in REM sleep stage segments. |
StagesSummaryRemCount |
Number of distinct REM sleep stage segments. |
StagesSummaryAsleepMinutes |
Total minutes spent asleep, if sleep data doesn't distinguish sleep stages (e.g., "CLASSIC"). |
StagesSummaryAsleepCount |
Number of periods spent asleep, if sleep data doesn't distinguish sleep stages (e.g., "CLASSIC"). |
StagesSummaryRestlessMinutes |
Total minutes spent restless (lightly disturbed but not fully awake), if sleep data doesn't distinguish sleep stages (e.g., "CLASSIC"). |
StagesSummaryRestlessCount |
Number of periods spent restless, if sleep data doesn't distinguish sleep stages (e.g., "CLASSIC"). |
|
|
The processing status of sleep stages algorithm, e.g., `"SUCCEEDED"`. |
MetadataProcessed |
Whether Google has finished processing this session. |
MetadataNap |
Whether this session was a nap. |
MetadataMainSleep |
Whether this session was the participant's main sleep for the day. |
MetadataManuallyEdited |
Whether the participant manually edited session. |
MetadataExternalId |
An external identifier for this session assigned by the recording app or device, when provided. |
CreateTime |
When the record was created in Google Health, in ISO 8601 format. Is always in UTC. |
UpdateTime |
When the record was last updated in Google Health, in ISO 8601 format. Is always in UTC. |
DataSourceRecordingMethod |
How the data was captured, e.g., "AUTOMATICALLY_RECORDED". |
DataSourcePlatform |
The platform that uploaded this session to Google Health, e.g., "FITBIT". |
DataSourceDeviceFormFactor |
The form factor of the device which recorded this session, e.g., "WATCH". |
DataSourceDeviceManufacturer |
The manufacturer of the device which recorded this session, e.g., `"Fitbit"`. |
DataSourceDeviceDisplayName |
The display name of the device which recorded this session, e.g., `“Sense 2”`. |
DataSourceApplicationPackageName |
The package name of the application that recorded the data, e.g., `"com.fitbit.app"`. |
DataSourceApplicationWebClientId |
The client ID of the application that recorded the data, when applicable. |
DataSourceApplicationGoogleWebClientId |
The Google OAuth 2.0 client ID of the web application or service that recorded the data, when applicable. |
Sleep Stages
| Field | Description |
|---|---|
GoogleHealthSleepKey |
Unique key for this sleep session. |
ParticipantIdentifier |
The identifier of the participant this entry was recorded for. Can be used to cross reference with Participants. |
StartDate |
Start time of the stage in ISO 8601 format, includes timezone offset information. |
EndDate |
End time of the stage in ISO 8601 format, includes timezone offset information. |
ParticipantID |
The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID). |
Type |
Stage type: "AWAKE", "LIGHT", "DEEP", or "REM". |
CreateTime |
When this stage record was created in Google Health, if reported, in ISO 8601 format. Is always in UTC. |
UpdateTime |
When this stage record was updated in Google Health, if reported, in ISO 8601 format. Is always in UTC. |
Sleep Out-Of-Bed Segments
| Field | Description |
|---|---|
GoogleHealthSleepKey |
Unique key for this sleep session. |
ParticipantIdentifier |
The identifier of the participant this entry was recorded for. Can be used to cross reference with Participants. |
StartDate |
Start time of the out-of-bed segment in ISO 8601 format. Includes timezone offset information. |
EndDate |
End time of the out-of-bed segment in ISO 8601 format. Includes timezone offset information. |
ParticipantID |
The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID). |
Sample CSV Export
Sleep
GoogleHealthSleepKey,ParticipantIdentifier,StartDate,EndDate,ParticipantID,ModifiedDate,SessionId,Type,MinutesInSleepPeriod,MinutesAfterWakeUp,MinutesToFallAsleep,MinutesAsleep,MinutesAwake,StagesSummaryAwakeMinutes,StagesSummaryAwakeCount,StagesSummaryLightMinutes,StagesSummaryLightCount,StagesSummaryDeepMinutes,StagesSummaryDeepCount,StagesSummaryRemMinutes,StagesSummaryRemCount,StagesSummaryAsleepMinutes,StagesSummaryAsleepCount,StagesSummaryRestlessMinutes,StagesSummaryRestlessCount,MetadataStagesStatus,MetadataProcessed,MetadataNap,MetadataMainSleep,MetadataManuallyEdited,MetadataExternalId,CreateTime,UpdateTime,DataSourceRecordingMethod,DataSourcePlatform,DataSourceDeviceFormFactor,DataSourceDeviceManufacturer,DataSourceDeviceDisplayName,DataSourceApplicationPackageName,DataSourceApplicationWebClientId,DataSourceApplicationGoogleWebClientId
dd539905-5205-5f9a-9480-74dee17da88f,MDH-123,2025-11-22T21:48:30-05:00,2025-11-23T07:15:00-05:00,11111111-aaaa-1111-1111-111111111111,2025-01-01T04:00:01Z,users/123000000000000000/dataTypes/sleep/dataPoints/300000000000000000,STAGES,566,,12,498,68,68,22,281,31,102,7,115,9,,,,,COMPLETE,True,False,True,,,2025-11-23T04:41:01.069135Z,2025-11-23T13:46:40.189423Z,AUTOMATICALLY_RECORDED,FITBIT,WATCH,Fitbit,Sense 2,com.fitbit.app,,
Sleep Stages
GoogleHealthSleepKey,ParticipantIdentifier,StartDate,EndDate,ParticipantID,Type,CreateTime,UpdateTime
dd539905-5205-5f9a-9480-74dee17da88f,MDH-123,2025-11-22T21:48:30-05:00,2025-11-22T22:39:00-05:00,11111111-aaaa-1111-1111-111111111111,AWAKE,2025-11-23T04:41:01.069135Z,2025-11-23T13:46:40.189423Z
dd539905-5205-5f9a-9480-74dee17da88f,MDH-123,2025-11-22T22:39:00-05:00,2025-11-23T00:02:00-05:00,11111111-aaaa-1111-1111-111111111111,LIGHT,,
Sleep Out-Of-Bed Segments
GoogleHealthSleepKey,ParticipantIdentifier,StartDate,EndDate,ParticipantID
dd539905-5205-5f9a-9480-74dee17da88f,MDH-123,2025-11-23T07:00:00-05:00,2025-11-23T07:15:00-05:00,11111111-aaaa-1111-1111-111111111111
Sample JSON Export
{
"GoogleHealthSleepKey": "dd539905-5205-5f9a-9480-74dee17da88f",
"ParticipantIdentifier": "MDH-123",
"StartDate": "2025-11-22T21:48:30-05:00",
"EndDate": "2025-11-23T07:15:00-05:00",
"ParticipantID": "11111111-aaaa-1111-1111-111111111111",
"ModifiedDate": "2025-01-01T04:00:01Z",
"SessionId": "users/123000000000000000/dataTypes/sleep/dataPoints/300000000000000000",
"Type": "STAGES",
"MinutesInSleepPeriod": 566,
"MinutesToFallAsleep": 12,
"MinutesAsleep": 498,
"MinutesAwake": 68,
"StagesSummaryAwakeMinutes": 68,
"StagesSummaryAwakeCount": 22,
"StagesSummaryLightMinutes": 281,
"StagesSummaryLightCount": 31,
"StagesSummaryDeepMinutes": 102,
"StagesSummaryDeepCount": 7,
"StagesSummaryRemMinutes": 115,
"StagesSummaryRemCount": 9,
"MetadataStagesStatus": "COMPLETE",
"MetadataProcessed": true,
"MetadataNap": false,
"MetadataMainSleep": true,
"CreateTime": "2025-11-23T04:41:01.069135Z",
"UpdateTime": "2025-11-23T13:46:40.189423Z",
"DataSourceRecordingMethod": "AUTOMATICALLY_RECORDED",
"DataSourcePlatform": "FITBIT",
"DataSourceDeviceFormFactor": "WATCH",
"DataSourceDeviceManufacturer": "Fitbit",
"DataSourceDeviceDisplayName": "Sense 2",
"DataSourceApplicationPackageName": "com.fitbit.app",
"Stages": [
{
"StartDate": "2025-11-22T21:48:30-05:00",
"EndDate": "2025-11-22T22:39:00-05:00",
"Type": "AWAKE",
"CreateTime": "2025-11-23T04:41:01.069135Z",
"UpdateTime": "2025-11-23T13:46:40.189423Z"
},
{
"StartDate": "2025-11-22T22:39:00-05:00",
"EndDate": "2025-11-23T00:02:00-05:00",
"Type": "LIGHT"
}
],
"OutOfBedSegments": [
{
"StartDate": "2025-11-23T07:00:00-05:00",
"EndDate": "2025-11-23T07:15:00-05:00"
}
]
}