Skip to content
Contact us
  • There are no suggestions because the search field is empty.

Garmin User Metrics Summary Export Format

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.

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.
Vo2MaxCycling An estimate of the maximum volume of oxygen for Cycling activities (in milliliters) the user can consume per minute per kilogram of body weight at maximum performance.

Sample CSV Export

ParticipantID,ParticipantIdentifier,SummaryId,CalendarDate,Vo2Max,Enhanced,FitnessAge,InsertedDate,Vo2MaxCycling
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,40.0
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,
    "Vo2MaxCycling":40.0,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-63b8b600",
    "InsertedDate": "2023-02-04T16:22:28"
}
...