Google Health API data types

The following table contains the full list of data types, with several columns to help you understand the representation of each type in the Google Health API, as well as the scope each is available under.

Important: The format of data type identifiers differs when the data type has more than one word. In an endpoint, the data type name must be in kebab case, such as body-fat. In a filter parameter, however, the data type name must be in snake case, such as body_fat.

Table: Google Health API data types

Data type   Endpoint ID   Filter parameter	Record type	Available operations	Scope	Webhook support
Active Minutes   active-minutes   active_minutes	Interval	reconcile, rollup, dailyRollup	activity_and_fitness
Active Zone Minutes   active-zone-minutes   active_zone_minutes	Interval	list, reconcile, rollup, dailyRollup	activity_and_fitness
Activity Level   activity-level   activity_level	Interval	list, reconcile	activity_and_fitness
Altitude   altitude   altitude	Interval	list, reconcile, rollup, dailyRollup	activity_and_fitness
Body Fat   body-fat   body_fat	Sample	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Calories In Heart Rate Zone   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Interval	rollup, dailyRollup	activity_and_fitness
Daily Heart Rate Variability   daily-heart-rate-variability   daily_heart_rate_variability	Daily	list, reconcile	health_metrics_and_measurements
Daily Heart Rate Zones   daily-heart-rate-zones   daily_heart_rate_zones	Daily	reconcile	health_metrics_and_measurements
Daily Oxygen Saturation   daily-oxygen-saturation   daily_oxygen_saturation	Daily	list, reconcile	health_metrics_and_measurements
Daily Respiratory Rate   daily-respiratory-rate   daily_respiratory_rate	Daily	list, reconcile	health_metrics_and_measurements
Daily Resting Heart Rate   daily-resting-heart-rate   daily_resting_heart_rate	Daily	list, reconcile	health_metrics_and_measurements
Daily Sleep Temperature Derivations   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Daily	list, reconcile	health_metrics_and_measurements
Daily VO2 Max   daily-vo2-max   daily_vo2_max	Daily	list, reconcile	activity_and_fitness
Distance   distance   distance	Interval	list, reconcile, rollup, dailyRollup	activity_and_fitness
Exercise   exercise   exercise	Session	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Floors   floors   floors	Interval	reconcile, rollup, dailyRollup	activity_and_fitness
Heart Rate   heart-rate   heart_rate	Sample	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Heart Rate Variability   heart-rate-variability   heart_rate_variability	Sample	list, reconcile	health_metrics_and_measurements
Hydration Log   hydration-log   hydration_log	Session	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
Oxygen Saturation   oxygen-saturation   oxygen_saturation	Sample	list, reconcile	health_metrics_and_measurements
Respiratory Rate Sleep Summary   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Sample	list, reconcile	health_metrics_and_measurements
Run VO2 Max   run-vo2-max   run_vo2_max	Sample	list, reconcile, rollup, dailyRollup	activity_and_fitness
Sedentary Period   sedentary-period   sedentary_period	Interval	list, reconcile, rollup, dailyRollup	activity_and_fitness
Sleep   sleep   sleep	Session	list, get, reconcile, create, update, batchDelete	sleep
Steps   steps   steps	Interval	list, reconcile, rollup, dailyRollup	activity_and_fitness
Time in Heart Rate Zone   time-in-heart-rate-zone   time_in_heart_rate_zone	Interval	reconcile, rollup, dailyRollup	activity_and_fitness
Total Calories   total-calories   total_calories	Interval	rollup, dailyRollup	activity_and_fitness
VO2 Max   vo2-max   vo2_max	Sample	list, reconcile	activity_and_fitness
Weight   weight   weight	Sample	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Data availability

Updates to the user's data is only available after they sync their activity tracker or manually enter new data into the Fitbit mobile or web app. The Fitbit device and Fitbit mobile app can automatically sync every 15 minutes when the Fitbit app is open on the mobile device and the two have an active data connection and are within Bluetooth range. If the user is tracking activity using MobileTrack, MobileTrack syncs every hour as long as the app is open.

Distance standards

Exercise distances, such as elevationGainMillimeters, are measured in millimeters as the standard unit for the following reasons:

1. Maintaining Data Precision: The most important reason for using millimeters is to ensure we don't lose any precision in the data we read and provide. Using a fine-grained unit like millimeters allows us to represent measurements with high accuracy.
2. Standardization: Millimeters are the designed standardized unit across our services. This consistency helps ensure a uniform experience for developers interacting with different parts of the API.
3. Broad Measurement System Support: Using a base unit like millimeters makes it straightforward for developers to convert to any other chosen unit, regardless of whether they are working with metric, imperial, or other measurement systems.