Articles in this section

See more

Apple HealthKitV2 Activity Summaries Export Format

  • Updated
Follow

HealthKitV2 activity summaries are generated by the Apple Watch and are the data behind the activity rings used to encourage Apple Watch users to stand, exercise, and move around.

Activity Summaries are captured on a daily basis—each activity summary covers a single day.

Field Description
HealthKitActivitySummaryKey A unique, auto-generated key for the activity summary.
ParticipantIdentifier The identifier of the participant the activity summary is for. Can be used to cross reference with Participants.
StartDate The start date of the activity summary, in ISO 8601 format. Includes timezone offset information. May be empty if no start date was recorded.
EndDate The end date of the activity summary, in ISO 8601 format. Includes timezone offset information.
ActiveEnergyBurned The active energy burned recorded by the Apple Watch, in kcal.
ActiveEnergyBurnedGoal The goal for ActiveEnergyBurned the participant set for themselves.
AppleExerciseTime The total exercise time recorded by the Apple Watch, in minutes.
AppleExerciseTimeGoal The goal for AppleExerciseTime the participant set for themselves.
AppleStandHours The number of hours in the day during which the participant stood up for at least 1 minute.
AppleStandHoursGoal The goal for AppleStandHours the participant set for themselves.
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.
If a participant re-syncs their device, you may observe duplicate samples. HealthKit samples are immutable, so when doing data analysis, your team will need to remove any samples that have the same HealthKitActivitySummaryKey and ParticipantIdentifier as another sample.

Sample CSV Export

HealthKitActivitySummaryKey,ParticipantIdentifier,StartDate,EndDate,ActiveEnergyBurned,ActiveEnergyBurnedGoal,AppleExerciseTime,AppleExerciseTimeGoal,AppleStandHours,AppleStandHoursGoal,InsertedDate
9aaf9d40-8534-54c5-94ba-19e4b2743b4d,TSTEND,2020-09-11T00:00:00-04:00,2020-09-11T23:59:59-04:00,0,460,0,30,0,12,2021-09-13T17:26:53Z
5553431a-c404-5f66-a55b-626b5dc66d37,TSTEND,2020-09-12T00:00:00-04:00,2020-09-12T23:59:59-04:00,297.87000000000029,460,15,30,11,12,2021-09-13T17:26:53Z
837d5232-12d8-5656-887e-76259970732e,TSTEND,2020-09-16T00:00:00-04:00,2020-09-16T23:59:59-04:00,0,460,0,30,0,12,2021-09-13T17:26:53Z
dcf90d1b-7ed4-552d-a3f2-10b7e0306980,TSTEND,2020-09-17T00:00:00-04:00,2020-09-17T23:59:59-04:00,58.508000000000045,460,3,30,4,12,2021-09-13T17:26:53Z
54ba6905-35fa-5d54-8395-856dd8a33694,TSTEND,2020-10-29T00:00:00-04:00,2020-10-29T23:59:59-04:00,0,460,0,30,0,12,2021-09-13T17:26:53Z
4c0e08e9-12fe-5019-a391-4d3185f514ec,TSTEND,2020-10-30T00:00:00-04:00,2020-10-30T23:59:59-04:00,234.777,460,8,30,11,12,2021-09-13T17:26:53Z
daf73246-4b22-5483-9e5d-f4c88259653b,TSTEND,2020-11-15T00:00:00-05:00,2020-11-15T23:59:59-05:00,0,460,0,30,0,12,2021-09-13T17:26:53Z
9d95bb78-ff92-510f-8268-57f0bfa4e530,TSTEND,2020-11-16T00:00:00-05:00,2020-11-16T23:59:59-05:00,211.35600000000005,460,9,30,11,12,2021-09-13T17:26:53Z
92d2601e-7e22-577d-81ca-110787c461d8,TSTEND,2021-05-24T00:00:00-04:00,2021-05-24T23:59:59-04:00,0,460,0,30,0,12,2021-09-13T17:26:53Z
a93748e1-9669-5778-bc0d-402e9d5d2b27,TSTEND,2021-05-25T00:00:00-04:00,2021-05-25T23:59:59-04:00,35.224,460,0,30,3,12,2021-09-13T17:26:53Z
ef9b2e63-4c5e-575e-b44e-744122388795,TSTEND,2021-05-31T00:00:00-04:00,2021-05-31T23:59:59-04:00,0,460,0,30,0,12,2021-09-13T17:26:53Z
26d5baaf-77fd-51ac-985f-b08fb0027ba3,TSTEND,2021-06-01T00:00:00-04:00,2021-06-01T23:59:59-04:00,0,460,0,30,0,12,2021-09-13T17:26:53Z

Sample JSON Export

{
  "HealthKitActivitySummaryKey":"9aaf9d40-8534-54c5-94ba-19e4b2743b4d",
  "ParticipantIdentifier":"TSTEND",
  "StartDate":"2020-09-11T00:00:00-04:00",
  "EndDate":"2020-09-11T23:59:59-04:00",
  "ActiveEnergyBurned":0.0,
  "ActiveEnergyBurnedGoal":460.0,
  "AppleExerciseTime":0.0,"AppleExerciseTimeGoal":30.0,
  "AppleStandHours":0.0,
  "AppleStandHoursGoal":12.0,
  "InsertedDate":"2021-09-13T17:26:53Z"
}

{
  "HealthKitActivitySummaryKey":"5553431a-c404-5f66-a55b-626b5dc66d37",
  "ParticipantIdentifier":"TSTEND",
  "StartDate":"2020-09-12T00:00:00-04:00",
  "EndDate":"2020-09-12T23:59:59-04:00",
  "ActiveEnergyBurned":297.87000000000029,
  "ActiveEnergyBurnedGoal":460.0,
  "AppleExerciseTime":15.0,
  "AppleExerciseTimeGoal":30.0,
  "AppleStandHours":11.0,
  "AppleStandHoursGoal":12.0,
  "InsertedDate":"2021-09-13T17:26:53Z"
}

Related articles