Health Connect Exercise Records Export Format
The Exercise Records export contains exercise sessions, which could be common fitness exercises like running or various other sports. There are optional sub-tables within an exercise record which can contain additional data about the session:
- Laps: Capture the time of a lap within an exercise session. Each lap contains start and end time and optional length, and may or may not be correlated with Segments.
- Routes: Capture a sequence of location points, with timestamps, which do not have to be in order.
- Segments: Each segment contains start and end time of the exercise, exercise type and optionally the number of repetitions.
In JSON format, all data is contained in a single file. In CSV format, sub-tables are exported as separate files.
- File Prefix: `HealthConnectRecords_Exercise`
- Laps File Prefix (CSV Format): `HealthConnectRecords_Exercise_Laps`
- Routes File Prefix (CSV Format): `HealthConnectRecords_Exercise_Route`
- Segments File Prefix (CSV Format): `HealthConnectRecords_Exercise_Segments`
Data Fields
|
Field |
Description |
|---|---|
|
|
A unique key for this Health Connect Record, used to cross reference Laps, Routes, and Segments 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. Includes timezone offset information. |
|
|
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. Includes timezone offset information. |
|
|
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. |
|
|
The type of exercise this record is for, such as `EXERCISE_TYPE_ELLIPTICAL` or `EXERCISE_TYPE_RUNNING`. A full list of types can be found in the Exercise Session Record documentation. |
|
|
Title of the exercise record |
|
|
Optional notes for this exercise session. |
|
|
Optional identifier of a scheduled or structured exercise this session is related to. |
|
|
The length of a lap in `LengthType` units. |
|
|
The unit of measure of `LengthValue` for a lap. |
|
|
The time of the route location point, in ISO 8601 format. Includes timezone offset information. |
|
|
The latitude of the route location point. |
|
|
The longitude of the route location point. |
|
|
The altitude of the route location point, in `AltitudeType` units. |
|
|
The unit of measure of `AltitudeValue`. |
|
|
Optional accuracy of the `Latitude` value, in `HorizontalAccuracyType` units. |
|
|
The unit of measure of `HorizontalAccuracyValue`. |
|
|
Optional accuracy of the `Longitude` value, in `VerticalAccuracyValue` units. |
|
|
The unit of measure of `VerticalAccuracyValue`. |
|
|
The type of exercise within this segment of the session. A full list of segment types can be found in the Exercise Segment documentation. |
|
|
Optional number of repetitions in this segment. |
Sample CSV Export
Exercise Records
HealthConnectRecordKey,ParticipantIdentifier,ParticipantID,MetadataDataOriginPackageName,MetadataLastModifiedTime,MetadataClientRecordID,MetadataClientRecordVersion,MetadataDeviceManufacturer,MetadataDeviceModel,MetadataDeviceType,MetadataRecordingMethod,InsertedDate,StartTime,StartZoneOffsetSetAtUpload,EndTime,EndZoneOffsetSetAtUpload,ExerciseType,Title,Notes,PlannedExerciseSessionId
fa4817b5-0912-393e-bbc7-8d432be8f63f,TST123456,1be320d5-57fa-4860-8fa2-033b27038c4e,com.huami.watch.hmwatchmanager,2025-11-09T22:33:49.071Z,ExerciseSessionHCData_1777777777700,175555720,,,TYPE_FITNESS_BAND,RECORDING_METHOD_ACTIVELY_RECORDED,2025-11-09T22:48:17.946Z,2025-11-09T16:43:40.000-05:00,,2025-11-09T17:18:42.000-05:00,,EXERCISE_TYPE_OTHER_WORKOUT,Skating,training,
Exercise Laps
HealthConnectRecordKey,StartTime,EndTime,LengthValue,LengthType
fa4817b5-0912-393e-bbc7-8d432be8f63f,2025-09-18T17:12:41.269-05:00,2025-09-18T17:28:55.885-05:00,1000,METERS
fa4817b5-0912-393e-bbc7-8d432be8f63f,2025-09-18T17:28:56.986-05:00,2025-09-18T17:44:44.245-05:00,1000,METERS
Exercise Route
HealthConnectRecordKey,Time,Latitude,Longitude,AltitudeValue,AltitudeType,HorizontalAccuracyValue,HorizontalAccuracyType,VerticalAccuracyValue,VerticalAccuracyType
fa4817b5-0912-393e-bbc7-8d432be8f63f,2025-11-09T17:28:55.885-05:00,-34.333,146.111801666667,30.1,METERS,1.2,METERS,3.3,METERS
fa4817b5-0912-393e-bbc7-8d432be8f63f,2025-11-09T17:28:57.183-05:00,-34.334,146.111701666667,,,,,,
fa4817b5-0912-393e-bbc7-8d432be8f63f,2025-11-09T17:28:58.259-05:00,-34.335,146.11185,,,,,,
Exercise Segments
HealthConnectRecordKey,StartTime,EndTime,SegmentType,Repetitions
fa4817b5-0912-393e-bbc7-8d432be8f63f,2025-11-09T16:43:40.000-05:00,2025-11-09T17:03:28.105-05:00,EXERCISE_SEGMENT_TYPE_SQUAT,10
fa4817b5-0912-393e-bbc7-8d432be8f63f,2025-11-09T17:03:28.105-05:00,2025-11-09T17:18:42.000-05:00,EXERCISE_SEGMENT_TYPE_ARM_CURL,20
Sample JSON Export
{
"HealthConnectRecordKey": "fa4817b5-0912-393e-bbc7-8d432be8f63f",
"ParticipantIdentifier": "TST123456",
"ParticipantID": "1be320d5-57fa-4860-8fa2-033b27038c4e",
"InsertedDate": "2025-11-09T22:48:17.946Z",
"Metadata": {
"DataOriginPackageName": "com.huami.watch.hmwatchmanager",
"LastModifiedTime": "2025-11-09T22:33:49.071Z",
"ClientRecordID": "ExerciseSessionHCData_1777777777700",
"ClientRecordVersion": 175555720,
"Device": { "Type": "TYPE_FITNESS_BAND" },
"RecordingMethod": "RECORDING_METHOD_ACTIVELY_RECORDED"
},
"StartTime": "2025-11-09T16:43:40.000-05:00",
"EndTime": "2025-11-09T17:18:42.000-05:00",
"ExerciseType": "EXERCISE_TYPE_OTHER_WORKOUT",
"Title": "Skating,
"Notes": "training",
"Laps": [
{
"EndTime": "2025-09-18T17:28:55.885-05:00",
"Length": {
"Type": "METERS",
"Value": 1000
},
"StartTime": "2025-09-18T17:12:41.269-05:00"
},
{
"EndTime": "2025-09-18T17:44:44.245-05:00",
"Length": {
"Type": "METERS",
"Value": 1000
},
"StartTime": "2025-09-18T17:28:56.986-05:00"
}
],
"Route": [
{
"Latitude": -34.333,
"Longitude": 146.111801666667,
"Time": "2025-11-09T17:28:55.885-05:00",
"Altitude": {
"Value": "30.1",
"Type": "METERS"
},
"HorizontalAccuracy": {
"Value": "1.2",
"Type": "METERS"
},
"VerticalAccuracy": {
"Value": "3.3",
"Type": "METERS"
}
},
{
"Latitude": -34.334,
"Longitude": 146.111701666667,
"Time": "2025-11-09T17:28:57.183-05:00"
},
{
"Latitude": -34.335,
"Longitude": 146.11185,
"Time": "2025-11-09T17:28:58.259-05:00"
}
],
"Segments": [
{
"EndTime": "2025-11-09T17:03:28.105-05:00",
"Repetitions": 10
"StartTime": "2025-11-09T16:43:40.000-05:00",
"SegmentType": "EXERCISE_SEGMENT_TYPE_SQUAT"
},
{
"EndTime": "2025-11-09T17:18:42.000-05:00",
"Repetitions": 20,
"StartTime": "2025-11-09T17:03:28.105-05:00",
"SegmentType": "EXERCISE_SEGMENT_TYPE_ARM_CURL"
}
]
}