Health Connect Aggregates Export Format

The Health Connect Aggregates exports contain aggregate metrics data over predetermined time periods (e.g., Hourly Steps, Daily Heart Rate, etc.).

Data Structure

One file will be created per type of data, with each file conforming to the same schema. The file name will correspond to the type of data (e.g. "HealthConnectAggregates_StepsHourly_20260401-20260402.csv"), with variances in the individual `MetricName` for each data type. Aggregate data types and their respective metrics are:

Active Calories Burned Daily
- File Prefix: HealthConnectAggregates_ActiveCaloriesBurnedDaily
- Metric Name: "ActiveCaloriesBurned_energy_total"
Distance Daily
- File Prefix: HealthConnectAggregates_DistanceDaily
- Metric Name: "Distance_distance_total"
Heart Rate Daily
- File Prefix: HealthConnectAggregates_HeartRateDaily
- Metric Names: "HeartRateSeries_bpm_min", "HeartRateSeries_bpm_max"

Steps Daily, Steps Half Hourly, Steps Hourly
- File Prefixes: HealthConnectAggregates_StepsDaily, HealthConnectAggregates_StepsHalfHourly, HealthConnectAggregates_StepsHourly
- Metric Names: "Steps_count_total"

Total Calories Burned Daily
- File Prefix: HealthConnectAggregates_TotalCaloriesBurnedDaily
- Metric Name: "TotalCaloriesBurned_energy_total"

Data Fields

Field	Description
`HealthConnectAggregateKey`	A unique key for this Health Connect aggregate.
`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).
`InsertedDate`	The date MyDataHelps received the data from Health Connect, in ISO 8601 format. Is always in UTC.
`StartTime`	The start time of this aggregate, representing a participant's day. Does not include timezone offset.
`EndTime`	The start time of this aggregate, representing a participant's day. Does not include timezone offset.
`MetricName`	The name of this aggregate data.
`Value`	The numeric value of this aggregate data.
`DataOriginPackageNames`	The package name(s) of the application(s) that generated this data.

Sample CSV Export

Heart Rate Daily Aggregate

HealthConnectAggregateKey,ParticipantIdentifier,ParticipantID,InsertedDate,StartTime,EndTime,MetricName,Value,DataOriginPackageNames
1fd4133e-1767-5a01-969d-b3451d2488b8,TST123456,1be320d5-57fa-4860-8fa2-033b27038c4e,2025-10-27T23:51:40Z,2025-09-10T00:00:00,2025-09-11T00:00:00,HeartRateSeries_bpm_min,70,com.google.android.apps.fitness
63e0a5bd-9c2f-51e6-9184-735c511de4db,TST123456,1be320d5-57fa-4860-8fa2-033b27038c4e,2025-10-27T23:51:40Z,2025-09-10T00:00:00,2025-09-11T00:00:00,HeartRateSeries_bpm_max,94,com.google.android.apps.fitness

Sample JSON Export

Heart Rate Daily Aggregate

{
    "HealthConnectAggregateKey": "1fd4133e-1767-5a01-969d-b3451d2488b8",
    "ParticipantIdentifier": "TST123456",
    "ParticipantID": "1be320d5-57fa-4860-8fa2-033b27038c4e",
    "InsertedDate": "2025-10-27T23:51:40Z",
    "StartTime": "2025-09-10T00:00:00",
    "EndTime": "2025-09-11T00:00:00",
    "MetricName": "HeartRateSeries_bpm_min",
    "Value": 70.0,
    "DataOriginPackageNames": "com.google.android.apps.fitness"
}
{
    "HealthConnectAggregateKey": "63e0a5bd-9c2f-51e6-9184-735c511de4db",
    "ParticipantIdentifier": "TST123456",
    "ParticipantID": "1be320d5-57fa-4860-8fa2-033b27038c4e",
    "InsertedDate": "2025-10-27T23:51:40Z",
    "StartTime": "2025-09-10T00:00:00",
    "EndTime": "2025-09-11T00:00:00",
    "MetricName": "HeartRateSeries_bpm_max",
    "Value": 94.0,
    "DataOriginPackageNames": "com.google.android.apps.fitness"
}