Google Health Sleep Export Format
Google Health data exports are not yet available, but data collection is available for MyDataHelps participants. This article is being published ahead of Google Health data export availability and is subject to change.
As a reminder, Google is deprecating the Fitbit API on September 30th, 2026. After this date, Fitbit data will only be available through Google Health. Please refer to the Migrating Fitbit to Google Health article for additional information.
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"
}
]
}