MyDataHelps currently supports Garmin data for two separate APIs:
- Health
- Activity
Many of these models are complex, with one or more sample arrays/maps included. Please see Garmin Health API Data Models and Garmin Activity API Data Models for the lists of data models currently supported by the Garmin export, as well as links to the corresponding support articles.
Some Garmin data can be updated or revised by Garmin after it is first exported by MDHD. In this case, you should replace the old date using the natural key. You should use the "InsertedDate" on the column to determine which data is the latest when updating. See the specific export articles linked below for more information on their natural keys.
To enable Garmin sensor data collection, navigate to the Sensor & EHR section of your project. To enable data exports, check the CSV or JSON box for Garmin within the Data Export Settings.
Garmin Health API Data Models
The following is a list of models currently supported.
- Health Snapshot Summary: a collection of key health-related insights recorded during a two-minute session on a compatible device.
- Daily Summary: a high-level view of the user’s entire day. They generally correspond to the data found on the "My Day" section of Garmin Connect.
- Third Party Daily Summary: retrieves a list of one or more daily summaries uploaded from third-party sources (e.g. Fitibit®) and not from Garmin devices.
- Respiration Summary: a feature available on some Garmin devices that tracks breathing rate throughout the day, during sleep, and during activities such as breathwork and yoga.
- Blood Pressure Summary: offer data from blood pressure readings taken using an Index™ BPM
- Epoch Summary: provides the ability to retrieve a list of summaries containing wellness data for a specific time range. Epoch summary records contain much of the same data available in Daily summaries, but with 15-minute time-slice granularity.
- Body Composition Summary: contains information about the user’s biometric data, like weight or body mass index.
- Stress Detail Summary: contains the user’s stress level values for a given day. Stress levels are provided as 3-minute averages of the real-time stress scores generated on the device with values ranging from 1 to 100.
- User Metrics Summary: 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.
- Pulse Ox Summary: contains blood oxygen saturation data.
- Heart rate variability (HRV) Summary: refers to beat-to-beat variations in heart rate and is data collected during the overnight sleep window for select devices.
- Sleep Summary: data records representing how long the user slept and the automatically classified sleep levels during that sleep event (e.g. light, deep periods) based on data generated by the user’s device.
Garmin Activity API Data Models
The following is a list of models currently supported.
- Activity Summary: represents high-level information from discrete fitness activities, such as running or swimming, that are specifically and intentionally started by the user on their device
- Manually Updated Activity Summary: activities created or edited by the user directly on the Connect site and not uploaded from a device.
- Activity Details Summary: represents detailed information about discrete fitness activities, such as running or swimming, that are specifically and intentionally started by the user on their device.
- MoveIQ Activity Summary: a feed of activities which have been automatically detected by the device based on movement patterns, like running or biking. These are not activities initiated by the user.