Articles in this section

See more

Garmin Third Party Daily Summary Export Format

  • Updated
Follow

This request is to retrieve a list of one or more daily summaries uploaded from third-party sources (e.g. Fitibit®) and not from Garmin devices.

  • File Prefix: GarminThirdPartyDailySummary
  • Sample File Prefix (For CSV format): GarminThirdPartyDailySummary_Samples
  • Natural Key: ParticipantID+ StartTimeInSeconds

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.
CalendarDate

The calendar date this summary would be displayed on in Garmin Connect. The date format is ‘yyyy-mm-dd’.
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).
BmrKilocalories BMR Kilocalories burned by existing Basal Metabolic Rate (calculated based on user height/weight/age/other demographic data).
Steps Count of steps recorded during the monitoring period.
DistanceInMeters Distance traveled in meters.
ActiveTimeInSeconds Portion of the monitoring period (in seconds) in which the device wearer was active.
ModerateIntensityDurationInSeconds Cumulative duration of activities of moderate intensity. Moderate intensity is defined as activity with MET value range 3-6.
VigorousIntensityDurationInSeconds Cumulative duration of activities of vigorous intensity. Vigorous intensity is defined as activity with MET value > 6.
FloorsClimbed Number of floors climbed during the monitoring period.
StepsGoal The user’s steps goal for this monitoring period.
MinHeartRateInBeatsPerMinute Minimum of heart rate values captured during the monitoring period, in beats per minute.
MaxHeartRateInBeatsPerMinute Maximum of heart rate values captured during the monitoring period, in beats per minute.
AverageHeartRateInBeatsPerMinute Average of heart rate values captured during the last 7 days, in beats per minute. The average heart rate value for the monitoring period can be calculated based on the data from timeOffsetHeartRateSamples.
Source The name of the source of the third party data. For example FITBIT.
timeOffsetHeartRateSamples Collection of mappings between offset from start time (in seconds) to a heart rate value recorded for that time, in beats per minute. Each entry is a representative sample of the previous 15 seconds from the given offset. Lack of entry for a given offset should be interpreted as no data available. For example, in the response below, the user had 75 BPM for the first 30 seconds of the daily summary, took off their device until the 3180 second time slice, and took it off again after the 3255 second entry.
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.

Sample CSV Export

Garmin Third Party Daily Summary

ParticipantID,ParticipantIdentifier,SummaryId,StartTimeInSeconds,StartTimeOffsetInSeconds,DurationInSeconds,CalendarDate,ActiveKilocalories,BmrKilocalories,Steps,DistanceInMeters,ActiveTimeInSeconds,ModerateIntensityDurationInSeconds,VigorousIntensityDurationInSeconds,FloorsClimbed,StepsGoal,MinHeartRateInBeatsPerMinute,MaxHeartRateInBeatsPerMinute,AverageHeartRateInBeatsPerMinute,Source,InsertedDate
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-622be280-15180-6,1647043200,0,86400,2022-03-12,-21888,1497,4510,-276166.0,0,0,0,32,5370,,,,FITBIT,2023-02-06T23:13:15Z

Garmin Third Party Daily Summary Samples

SummaryId,OffsetInSeconds,HeartRate
x45e31a7-622be280-15180-6,15,70
x45e31a7-622be280-15180-6,30,70
x45e31a7-622be280-15180-6,45,70
x45e31a7-622be280-15180-6,60,70

Sample JSON Export

{
    "StartTimeInSeconds": 1647043200,
    "StartTimeOffsetInSeconds": 0,
    "DurationInSeconds": 86400,
    "Steps": 4510,
    "DistanceInMeters": -276166.0,
    "ActiveTimeInSeconds": 0,
    "ActiveKilocalories": -21888,
    "BmrKilocalories": 1497,
    "ModerateIntensityDurationInSeconds": 0,
    "VigorousIntensityDurationInSeconds": 0,
    "FloorsClimbed": 32,
    "Source": "FITBIT",
    "CalendarDate": "2022-03-12",
    "StepsGoal": 5370,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-622be280-15180-6",
    "InsertedDate": "2023-02-06T23:13:15"
}

Related articles