Skip to content
AF
Google Health API reference

Calories In Heart Rate Zone: the Google Health API calories-in-heart-rate-zone 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

Calories In Heart Rate Zone (calories-in-heart-rate-zone) is an Interval data type in the Google Health API. Google's data-types table lists rollup and dailyRollup for it under the .activity_and_fitness.readonly and .activity_and_fitness.writeonly scopes, with a storage resolution of 1 minute. The table marks it with webhook support. Google's Fitbit migration table maps the Fitbit Web API's caloriesOut in each heart rate zone data to it.

Calories In Heart Rate Zone at a glance

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

Display name
Calories In Heart Rate Zone
dataType (in endpoint URLs)
calories-in-heart-rate-zone
filter parameter
calories_in_heart_rate_zoneGoogle: “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
Interval — Google: “Represents measurements recorded over a duration.”
Storage resolution
1 minute
Webhook support
Yes · automatic-subscription token WEBHOOK_DATA_TYPE_CALORIES_IN_HEART_RATE_ZONE
True zeros support
Not marked in Google’s table
Channel
v4
DataPoint field
none in the discovery documents — see the flags below
Compatible devices
0 in Google’s table

Operations and request paths

The operations Google’s table lists for calories-in-heart-rate-zone, 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 calories-in-heart-rate-zone. 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
rolluprollUpsame name, different casePOST https://health.googleapis.com/v4/users/{usersId}/dataTypes/calories-in-heart-rate-zone/dataPoints:rollUp
dailyRollupdailyRollUpsame name, different casePOST https://health.googleapis.com/v4/users/{usersId}/dataTypes/calories-in-heart-rate-zone/dataPoints:dailyRollUp

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

Scopes

The scopes Google’s table lists for calories-in-heart-rate-zone, 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.activity_and_fitness.readonlyreadSee your Google Health activity and fitness data.
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonlywriteAdd activity and fitness data to Google Health, and edit or delete the data it adds.

Rollup fields

rollUp returns RollupDataPoint.caloriesInHeartRateZone

The discovery document: “Returned by default when rolling up data points from the calories-in-heart-rate-zone data type, or when requested explicitly using the calories-in-heart-rate-zone rollup type identifier.”

CaloriesInHeartRateZoneRollupValue — Google: “Represents the result of the rollup of the calories in heart rate zone data type.”

FieldTypeGoogle’s description
caloriesInHeartRateZonesarray<CaloriesInHeartRateZoneValue>List of calories burned in each heart rate zone.

CaloriesInHeartRateZoneValue

Google: “Represents the amount of kilocalories burned in a specific heart rate zone.”

FieldTypeGoogle’s description
heartRateZonestringThe heart rate zone.
  • HEART_RATE_ZONE_TYPE_UNSPECIFIED — Unspecified heart rate zone.
  • LIGHT — The light heart rate zone.
  • MODERATE — The moderate heart rate zone.
  • VIGOROUS — The vigorous heart rate zone.
  • PEAK — The peak heart rate zone.
kcalnumber/doubleThe amount of kilocalories burned in the specified heart rate zone.

dailyRollUp returns DailyRollupDataPoint.caloriesInHeartRateZone

The discovery document: “Returned by default when rolling up data points from the calories-in-heart-rate-zone data type, or when requested explicitly using the calories-in-heart-rate-zone rollup type identifier.”

The same CaloriesInHeartRateZoneRollupValue as the rollUp result above.

Fitbit Web API predecessor

Google’s Fitbit Web API → Google Health API data-type table maps caloriesOut in each heart rate zone to calories-in-heart-rate-zone.

Fitbit Web API scopes Google maps to calories-in-heart-rate-zone’s scopes: activity, cardio_fitness.

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

Where Google’s guides name calories-in-heart-rate-zone

  • “A maximum query range of 14 days for calories-in-heart-rate-zone, heart-rate, active-minutes, and total-calories.”Google's data-types page, “Query constraints”
  • “A maximum range of 14 days for calories-in-heart-rate-zone, heart-rate, active-minutes, and total-calories.”Google's endpoints guide, “Query historical data”

Where Google’s pages disagree

Published as found, with the texts that disagree; nothing here is corrected by us.

  • No v4 DataPoint field

    Neither discovery document has a DataPoint property for calories-in-heart-rate-zone; it exists only as a rollup (caloriesInHeartRateZone), matching the table's operations (rollup, dailyRollup).

    • Google's data-types page: “Calories In Heart Rate Zone”
    • Google's data-types page: “rollup, dailyRollup”
    • the v4 discovery document: “Returned by default when rolling up data points from the calories-in-heart-rate-zone data type, or when requested explicitly using the calories-in-heart-rate-zone rollup type identifier.”

Google’s documentation

Related on this site

Questions

Which OAuth scopes does the Google Health API calories-in-heart-rate-zone data type need?

Google's data-types table (read 2026-10-17) lists https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly and https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly for calories-in-heart-rate-zone. The Scopes page's consent text: .activity_and_fitness.readonly, "See your Google Health activity and fitness data."; .activity_and_fitness.writeonly, "Add activity and fitness data to Google Health, and edit or delete the data it adds."

Can apps write calories in heart rate zone data to the Google Health API?

Not according to Google's data-types table, read 2026-10-17: it lists only rollup and dailyRollup for calories-in-heart-rate-zone, and no create, update or batchDelete operation.

How do you aggregate calories-in-heart-rate-zone data with the Google Health API?

With the rollup methods Google's table lists for it. rollUp (POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/calories-in-heart-rate-zone/dataPoints:rollUp) returns RollupDataPoint.caloriesInHeartRateZone, a CaloriesInHeartRateZoneRollupValue with caloriesInHeartRateZones; dailyRollUp (POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/calories-in-heart-rate-zone/dataPoints:dailyRollUp) returns DailyRollupDataPoint.caloriesInHeartRateZone, a CaloriesInHeartRateZoneRollupValue with caloriesInHeartRateZones. Each field is described on this page as the discovery document describes it.

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

Google's Fitbit Web API migration table maps the Fitbit Web API's "caloriesOut in each heart rate zone" to calories-in-heart-rate-zone. The Fitbit Web API scopes Google maps to its scopes: activity and cardio_fitness.

Other activity and fitness data types

All activity and fitness 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