Skip to main content

Garmin User Metrics Summary Export Format

  • Updated

User Metrics are per-user calculations performed by Garmin based on the underlying data uploaded from the user’s device. This data can be specific to a single device and field availability is dependent on device model support.

  • File Prefix: GarminUserMetricsSummary
  • Natural Key: ParticipantID+ CalendarDate

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

The calendar date this summary would be displayed on in Garmin Connect. The date format is ‘yyyy-mm-dd’.
Vo2Max An estimate of the maximum volume of oxygen (in milliliters) the user can consume per minute per kilogram of body weight at maximum performance.
Enhanced When set to true, the Fitness Age provided has been calculated using Garmin's enhanced algorithm (taking into account activity intensity, resting heart rate and body fat percentage or BMI). When set to false, the value provided for Fitness Age has been calculated using Garmin's older method of estimation. 
FitnessAge An estimation of the ‘age’ of the user’s fitness level, calculated by comparing internal fitness metrics with the average readings of biometrically similar users by age. For instance, a fitness age of 48 indicates that the user’s physical fitness is similar to that of an average 48- year-old person of the same gender. Improved Fitness Age (enhanced =true) takes into account activity intensity, resting heart rate and body fat percentage or BMI.
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.

Sample CSV Export

ParticipantID,ParticipantIdentifier,SummaryId,CalendarDate,Vo2Max,Enhanced,FitnessAge,InsertedDate
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63b76480,2023-01-06,,True,47,2023-02-04T16:22:28Z
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63b8b600,2023-01-07,,True,47,2023-02-04T16:22:28Z
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63b0cd00,2023-01-01,,True,47,2023-02-04T16:22:28Z
...
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63d46580,2023-01-28,,True,47,2023-02-04T16:22:28Z

Sample JSON Export

{
    "CalendarDate": "2023-01-06",
    "Enhanced": true,
    "FitnessAge": 47,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-63b76480",
    "InsertedDate": "2023-02-04T16:22:28"
}
{
    "CalendarDate": "2023-01-07",
    "Enhanced": true,
    "FitnessAge": 47,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-63b8b600",
    "InsertedDate": "2023-02-04T16:22:28"
}
...

Was this article helpful?