Articles in this section

See more

Garmin Epoch Summary Export Format

  • Updated
Follow

This service provides the ability to retrieve a list of summaries containing wellness data for a specific time range. Epoch summary records contain much of the same data available in Daily summaries, but with 15-minute time-slice granularity.

  • File Prefix: GarminEpochSummary
  • Natural Key: ParticipantID+ SummaryId

For a complete list of all the export file types possible, see the Garmin Export Overview.

Table of Contents

Data Fields

Field Description
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
ParticipantIdentifier The identifier of the participant the activity summary is for. Can be used to cross reference with Participants.
SummaryId Unique identifier for the summary.
StartTimeInSeconds

Start time of the activity in seconds since January 1, 1970, 00:00:00 UTC (Unix timestamp).
StartTimeOffsetInSeconds Offset in seconds to add to startTimeInSeconds to derive the “local” time of the device that captured the data.
DurationInSeconds

The duration of the measurement period in seconds.
ActivityType

Text description of the activity type. See Appendix A for a complete list.
ActiveTimeInSeconds

Portion of the monitoring period (in seconds) in which the device wearer was active for this activity type. The sum of active times of all epochs of the same start time (and different activity types) should be equal to the duration.
Steps Count of steps recorded during the monitoring period.
DistanceInMeters Distance traveled in meters.
ActiveKilocalories Active kilocalories (dietary calories) burned during the monitoring period. This includes only the calories burned by the activity and not calories burned as part of the basal metabolic rate (BMR).
Met MET (Metabolic Equivalent of Task) value for the active time for this activity type. 
Intensity Qualitative measure of intensity.
MeanMotionIntensity The average of motion intensity scores for all minutes in this monitoring period.
MaxMotionIntensity The largest motion intensity score of any minute in this monitoring period.
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.

Sample CSV Export

ParticipantID,ParticipantIdentifier,SummaryId,StartTimeInSeconds,StartTimeOffsetInSeconds,DurationInSeconds,ActivityType,ActiveTimeInSeconds,Steps,DistanceInMeters,ActiveKilocalories,Met,Intensity,MeanMotionIntensity,MaxMotionIntensity,InsertedDate
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63e3d510-6,1675875600,-18000,900,WALKING,90,56,45.36,1,1.4937773,ACTIVE,1.8333333333333333,2.0,2023-02-08T22:33:12Z
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63e3d894-6,1675876500,-18000,900,WALKING,45,24,19.44,0,1.0,ACTIVE,2.0,2.0,2023-02-08T22:33:12Z
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63e3dc18-8,1675877400,-18000,900,SEDENTARY,900,0,0.0,0,1.0,SEDENTARY,0.0,4.0,2023-02-08T22:33:12Z
...
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63d8a758-8,1675143000,-18000,900,SEDENTARY,900,0,0.0,0,1.0,SEDENTARY,0.0,2.0,2023-02-04T16:22:26Z

Sample JSON Export

{
    "StartTimeInSeconds": 1675875600,
    "StartTimeOffsetInSeconds": -18000,
    "ActivityType": "WALKING",
    "DurationInSeconds": 900,
    "ActiveTimeInSeconds": 90,
    "Steps": 56,
    "DistanceInMeters": 45.36,
    "ActiveKilocalories": 1,
    "Met": 1.4937773,
    "Intensity": "ACTIVE",
    "MeanMotionIntensity": 1.8333333333333333,
    "MaxMotionIntensity": 2.0,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-63e3d510-6",
    "InsertedDate": "2023-02-08T22:33:12"
}
{
    "StartTimeInSeconds": 1675876500,
    "StartTimeOffsetInSeconds": -18000,
    "ActivityType": "WALKING",
    "DurationInSeconds": 900,
    "ActiveTimeInSeconds": 45,
    "Steps": 24,
    "DistanceInMeters": 19.44,
    "ActiveKilocalories": 0,
    "Met": 1.0,
    "Intensity": "ACTIVE",
    "MeanMotionIntensity": 2.0,
    "MaxMotionIntensity": 2.0,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-63e3d894-6",
    "InsertedDate": "2023-02-08T22:33:12"
}
{
    "StartTimeInSeconds": 1675877400,
    "StartTimeOffsetInSeconds": -18000,
    "ActivityType": "SEDENTARY",
    "DurationInSeconds": 900,
    "ActiveTimeInSeconds": 900,
    "Steps": 0,
    "DistanceInMeters": 0.0,
    "ActiveKilocalories": 0,
    "Met": 1.0,
    "Intensity": "SEDENTARY",
    "MeanMotionIntensity": 0.0,
    "MaxMotionIntensity": 4.0,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-63e3dc18-8",
    "InsertedDate": "2023-02-08T22:33:12"
}
...

Related articles