Articles in this section

See more

Garmin Heart Rate Variability Summary Export Format

  • Updated
Follow

Heart rate variability (HRV) refers to beat-to-beat variations in heart rate and is data collected during the overnight sleep window for select devices.

  • File Prefix: GarminHrvSummary
  • Sample File Prefix (For CSV format): GarminHrvSummary_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’.
LastNightAvg The average heart rate variability value from the last night of data.
LastNight5MinHigh The maximum HRV value over any 5 minute interval of the last night of data.
HrvValues A map of the HRV values and the time offset of when each value was recorded. Lack of entry for a given offset should be interpreted as no data available.
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.

Sample CSV Export

Garmin HRV Summary

ParticipantID,ParticipantIdentifier,SummaryId,StartTimeInSeconds,StartTimeOffsetInSeconds,DurationInSeconds,CalendarDate,LastNightAvg,LastNight5MinHigh,InsertedDate
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63e08aa9,1675659945,0,2,2023-02-06,,,2023-02-06T08:02:27Z
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63df3929,1675573545,0,2,2023-02-05,,,2023-02-05T16:01:26Z
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63bba06f,1673240687,0,2,2023-01-09,,,2023-02-04T16:22:32Z
...
1be320d5-57fa-4860-8fa2-033b27038c4e,TST12345,x45e31a7-63c4cf44,1673842500,-18000,34682,2023-01-16,51,84,2023-02-04T16:22:32Z

Garmin HRV Summary Samples

SummaryId,OffsetInSeconds,Value
x45e31a7-63bcdf00,240,28
x45e31a7-63bcdf00,540,25
x45e31a7-63bcdf00,840,33
...
x45e31a7-63c4cf44,34682,60

Sample JSON Export

{
    "CalendarDate": "2023-01-10",
    "StartTimeInSeconds": 1673322240,
    "DurationInSeconds": 29940,
    "StartTimeOffsetInSeconds": -18000,
    "LastNightAvg": 45,
    "LastNight5MinHigh": 66,
    "HrvValues": {
        "240": 28,
        "540": 25,
        "840": 33,
        ...
        "29940": 30
    },
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687",
    "ParticipantIdentifier": "TST12345",
    "SummaryId": "x45e31a7-63bcdf00",
    "InsertedDate": "2023-02-04T16:22:32"
}
...

Related articles