Articles in this section

See more

Garmin Pulse Ox Summary Export Format

  • Updated
Follow

Pulse Ox summaries contain blood oxygen saturation data.

  • File Prefix: GarminPulseOxSummary
  • Sample File Prefix (For CSV format): GarminPulseOxSummary_Samples
  • 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.
CalendarDate

The calendar date this summary would be displayed on in Garmin Connect. The date format is ‘yyyy-mm-dd’.
OnDemand A Boolean to show whether this pulse ox summary represents an on-demand reading or an averaged acclimation reading.
timeOffsetSpo2Values Collection of key-value pairs where the key is offset in seconds from the startTimeInSeconds and the value is the SpO2 measurement taken at that time (1 sample/minute).
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.

Sample CSV Export

Garmin Pulse Ox Summary

ParticipantID,ParticipantIdentifier,SummaryId,StartTimeInSeconds,StartTimeOffsetInSeconds,DurationInSeconds,CalendarDate,OnDemand,InsertedDate
b728e3e8-1e97-453c-a3a5-5f4a1e5ce687,TST12345,x45e31a7-63e32c50-f654-6,1535400706,3600,86400,2018-08-27,false,2023-02-08T22:33:12

Garmin Pulse Ox Summary Samples

SummaryId,OffsetInSeconds,Value
x45e31a7-63e32c50-f654-6,7140,94
x45e31a7-63e32c50-f654-6,10740,98
x45e31a7-63e32c50-f654-6,10800,99
...
x45e31a7-63e32c50-f654-6,86340,96

Sample JSON Export

{
    "CalendarDate": "2018-08-27",
    "StartTimeInSeconds": 1535400706,
    "DurationInSeconds": 86400,
    "StartTimeOffsetInSeconds": 3600,
    "TimeOffsetSpo2Values": 
        {
            "7140": 94,
            "10740": 98,
            "10800": 99,
            … 
            "86340": 96
        },
    "onDemand": false,
    "ParticipantID": "b728e3e8-1e97-453c-a3a5-5f4a1e5ce687", 
    "ParticipantIdentifier": "TST12345", 
    "SummaryId": "x45e31a7-63e32c50-f654-6", 
    "InsertedDate": "2023-02-08T22:33:12" 
}

Related articles