Skip to content
AF
Google Health API reference

Heart Rate Variability: the Google Health API heart-rate-variability data type

Read from Google’s documentation on 2026-10-17 · discovery document revision 20261014 · Google’s data-types page last updated 2026-10-06

Heart Rate Variability (heart-rate-variability) is a Sample data type in the Google Health API. Google's data-types table lists list and reconcile for it under the .health_metrics_and_measurements.readonly and .health_metrics_and_measurements.writeonly scopes. The table marks it with webhook support. Google's Fitbit migration table maps the Fitbit Web API's HRV Intraday data to it.

Heart Rate Variability at a glance

From the Heart Rate Variability row of Google’s data-types table, joined to the discovery document’s DataPoint schema.

Display name
Heart Rate Variability
dataType (in endpoint URLs)
heart-rate-variability
filter parameter
heart_rate_variabilityGoogle: “The identifier separated by underscores (for example, active_minutes) used as the value for the dataType filter parameter in daily rollup and rollup requests.”
Record type
Sample — Google: “Represents instantaneous measurements.”
Storage resolution
not stated in Google’s table
Webhook support
Yes · automatic-subscription token WEBHOOK_DATA_TYPE_HEART_RATE_VARIABILITY
True zeros support
Not marked in Google’s table
Channel
v4
DataPoint field
DataPoint.heartRateVariability → HeartRateVariabilityIts description: “Optional. Data for points in the heart-rate-variability sample data type collection.”
Compatible devices
28 in Google’s table

Operations and request paths

The operations Google’s table lists for heart-rate-variability, each matched to its users.dataTypes.dataPoints method in the discovery document. The path is the documented path template (the method’s flatPath on https://health.googleapis.com/) with {dataTypesId} filled in as heart-rate-variability. Google on {user}: “The {user} can be either the alias me or the authenticated user's numeric Health User ID (retrieved via GetIdentity).”

Table listsMethodDocumented path template
listlistGET https://health.googleapis.com/v4/users/{usersId}/dataTypes/heart-rate-variability/dataPoints
reconcilereconcileGET https://health.googleapis.com/v4/users/{usersId}/dataTypes/heart-rate-variability/dataPoints:reconcile

Every method, and how many of the data types list it: the methods overview.

Scopes

The scopes Google’s table lists for heart-rate-variability, as full URLs, with the consent text Google’s Scopes page gives each. Every Google Health API scope.

ScopeAccessGoogle’s permission text
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonlyreadSee your Google Health health metrics and measurement data.
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonlywriteAdd health metric and measurements data to Google Health, and edit or delete the data it adds.

Fields of Heart Rate Variability

The schema the discovery document gives DataPoint.heartRateVariability, required fields first. Types are as the discovery document states them; the label is the word Google’s description opens with. The schemas its fields refer to follow, one level deep.

HeartRateVariability — Google: “Captures user's heart rate variability (HRV) as measured by the root mean square of successive differences (RMSSD) between normal heartbeats or by standard deviation of the inter-beat intervals (SDNN).”

FieldTypeGoogle’s description
sampleTimeRequiredObservationSampleTimeRequired. The time of the heart rate variability measurement.
metadataOptionalHeartRateVariabilityMetadataOptional. Additional information about the heart rate variability measurement.
rootMeanSquareOfSuccessiveDifferencesMillisecondsOptionalnumber/doubleOptional. The root mean square of successive differences between normal heartbeats. This is a measure of heart rate variability used by Google Health. Must be in the range [1, 200].
standardDeviationMillisecondsOptionalnumber/doubleOptional. The standard deviation of the heart rate variability measurement.

ObservationSampleTime

Google: “Represents a sample time of an observed data point.”

FieldTypeGoogle’s description
physicalTimeRequiredstring/google-datetimeRequired. The time of the observation.
utcOffsetRequiredstring/google-durationRequired. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC).
civilTimeOutput onlyCivilDateTimeOutput only. The civil time in the timezone the subject is in at the time of the observation.

HeartRateVariabilityMetadata

Google: “Metadata for HeartRateVariability.”

FieldTypeGoogle’s description
highFrequencyPowerOptionalnumber/doubleOptional. The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz).
lowFrequencyPowerOptionalnumber/doubleOptional. The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz).

Fitbit Web API predecessor

Google’s Fitbit Web API → Google Health API data-type table maps HRV Intraday to heart-rate-variability.

Fitbit Web API scopes Google maps to heart-rate-variability’s scopes: blood_glucose, heartrate, oxygen_saturation, respiratory_rate, temperature, weight.

Google’s full Fitbit Web API mapping tables · the migration playbook

Compatible devices

The 28 devices Google’s table lists as able to record and sync heart-rate-variability.

  • Fitbit Air
  • Fitbit Alta
  • Fitbit Alta HR
  • Fitbit Blaze
  • Fitbit Charge 2
  • Fitbit Charge 3
  • Fitbit Charge 4
  • Fitbit Charge 5
  • Fitbit Charge 6
  • Fitbit Flex 2
  • Fitbit Inspire
  • Fitbit Inspire 2
  • Fitbit Inspire 3
  • Fitbit Inspire HR
  • Fitbit Ionic
  • Fitbit Luxe
  • Fitbit MobileTrack
  • Pixel Watch
  • Pixel Watch 2
  • Pixel Watch 3
  • Pixel Watch 4
  • Fitbit Sense
  • Fitbit Sense 2
  • Fitbit Versa
  • Fitbit Versa 2
  • Fitbit Versa 3
  • Fitbit Versa 4
  • Fitbit Versa Lite

Google’s documentation

Related on this site

Questions

Which OAuth scopes does the Google Health API heart-rate-variability data type need?

Google's data-types table (read 2026-10-17) lists https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly and https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly for heart-rate-variability. The Scopes page's consent text: .health_metrics_and_measurements.readonly, "See your Google Health health metrics and measurement data."; .health_metrics_and_measurements.writeonly, "Add health metric and measurements data to Google Health, and edit or delete the data it adds."

Can apps write heart rate variability data to the Google Health API?

Not according to Google's data-types table, read 2026-10-17: it lists only list and reconcile for heart-rate-variability, and no create, update or batchDelete operation.

How do you aggregate heart-rate-variability data with the Google Health API?

Not with rollUp or dailyRollUp, going by Google's data-types table: it lists only list and reconcile for heart-rate-variability. Read the data points with list (or reconcile, where listed) and compute any summary yourself.

What did the Google Health API heart-rate-variability data type replace in the Fitbit Web API?

Google's Fitbit Web API migration table maps the Fitbit Web API's "HRV Intraday" to heart-rate-variability. The Fitbit Web API scopes Google maps to its scopes: blood_glucose, heartrate, oxygen_saturation, respiratory_rate, temperature and weight.

Other health metrics and measurements data types

All health metrics and measurements data types →

Sources checked

Google’s text is quoted for identification; each guide page’s footer reads: “Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License.”. Generated from Google’s pages by scripts/fetch-google-health-api.mjs, not typed by hand; Google’s documentation remains the authority.

← All Google Health API data types