Google Health API reference

Active Minutes: the Google Health API active-minutes 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

Active Minutes (active-minutes) is an Interval data type in the Google Health API. Google's data-types table lists list, reconcile, 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 names no Fitbit Web API predecessor for it.

Active Minutes at a glance

From the Active Minutes row of Google’s data-types table, joined to the discovery document’s DataPoint schema.

Display name: Active Minutes
dataType (in endpoint URLs): active-minutes
filter parameter: active_minutesGoogle: “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_ACTIVE_MINUTES
True zeros support: Not marked in Google’s table
Channel: v4
DataPoint field: DataPoint.activeMinutes → ActiveMinutesIts description: “Optional. Data for points in the active-minutes interval data type collection.”
Compatible devices: 10 in Google’s table

Operations and request paths

The operations Google’s table lists for active-minutes, 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 active-minutes. Google on {user}: “The {user} can be either the alias me or the authenticated user's numeric Health User ID (retrieved via GetIdentity).”

Table lists	Method	Documented path template
`list`	`list`	`GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/active-minutes/dataPoints`
`reconcile`	`reconcile`	`GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/active-minutes/dataPoints:reconcile`
`rollup`	`rollUp`same name, different case	`POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/active-minutes/dataPoints:rollUp`
`dailyRollup`	`dailyRollUp`same name, different case	`POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/active-minutes/dataPoints:dailyRollUp`

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

Scopes

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

Scope	Access	Google’s permission text
`https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly`	read	See your Google Health activity and fitness data.
`https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly`	write	Add activity and fitness data to Google Health, and edit or delete the data it adds.

Fields of Active Minutes

The schema the discovery document gives DataPoint.activeMinutes, 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.

ActiveMinutes — Google: “Record of active minutes in a given time interval.”

Field	Type	Google’s description
`activeMinutesByActivityLevel`Required	`array<ActiveMinutesByActivityLevel>`	Required. Active minutes by activity level. At most one record per activity level is allowed.
`interval`Required	`ObservationTimeInterval`	Required. Observed interval.

`ActiveMinutesByActivityLevel`

Google: “Active minutes at a given activity level.”

Field	Type	Google’s description
`activeMinutes`Required	`string/int64`	Required. Number of whole minutes spent in activity.
`activityLevel`Required	`string`	Required. The level of activity. `ACTIVITY_LEVEL_UNSPECIFIED` — Activity level is unspecified. `LIGHT` — Light activity level. `MODERATE` — Moderate activity level. `VIGOROUS` — Vigorous activity level.

`ObservationTimeInterval`

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

Field	Type	Google’s description
`endTime`Required	`string/google-datetime`	Required. Observed interval end time.
`endUtcOffset`Required	`string/google-duration`	Required. The offset of the user's local time at the end of the observation relative to the Coordinated Universal Time (UTC).
`startTime`Required	`string/google-datetime`	Required. Observed interval start time.
`startUtcOffset`Required	`string/google-duration`	Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC).
`civilEndTime`Output only	`CivilDateTime`	Output only. Observed interval end time in civil time in the timezone the subject is in at the end of the observed interval
`civilStartTime`Output only	`CivilDateTime`	Output only. Observed interval start time in civil time in the timezone the subject is in at the start of the observed interval

Rollup fields

`rollUp` returns `RollupDataPoint.activeMinutes`

The discovery document: “Returned by default when rolling up data points from the active-minutes data type, or when requested explicitly using the active-minutes rollup type identifier.”

ActiveMinutesRollupValue — Google: “Represents the result of the rollup of the active minutes data type.”

Field	Type	Google’s description
`activeMinutesRollupByActivityLevel`	`array<ActiveMinutesRollupByActivityLevel>`	Active minutes by activity level. At most one record per activity level is allowed.

`ActiveMinutesRollupByActivityLevel`

Google: “Active minutes by activity level.”

Field	Type	Google’s description
`activeMinutesSum`	`string/int64`	Number of whole minutes spent in activity.
`activityLevel`	`string`	The level of activity. `ACTIVITY_LEVEL_UNSPECIFIED` — Activity level is unspecified. `LIGHT` — Light activity level. `MODERATE` — Moderate activity level. `VIGOROUS` — Vigorous activity level.

`dailyRollUp` returns `DailyRollupDataPoint.activeMinutes`

The discovery document: “Returned by default when rolling up data points from the active-minutes data type, or when requested explicitly using the active-minutes rollup type identifier.”

The same ActiveMinutesRollupValue as the rollUp result above.

Fitbit Web API predecessor

Google’s Fitbit Web API → Google Health API data-type table has no row for active-minutes, so it names no Fitbit Web API predecessor.

Fitbit Web API scopes Google maps to active-minutes’s scopes: activity, cardio_fitness.

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

Where Google’s guides name active-minutes

“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”

Compatible devices

The 10 devices Google’s table lists as able to record and sync active-minutes.

Fitbit Air
Fitbit Alta
Fitbit Alta HR
Fitbit Blaze
Fitbit Charge 2
Fitbit Charge 3
Fitbit Flex 2
Fitbit Inspire
Fitbit Inspire HR
Pixel Watch 4

Google’s documentation

Active Minutes in the v4 REST reference

Related on this site

Active Minutes API: Activity Intensity, Exercise Time and Sedentary Time — the metric on every platform this site covers, each type quoted in its platform's own words
Google Health API webhooks
Verification and rate limits
The Fitbit Web API turn-off

Questions

Which OAuth scopes does the Google Health API active-minutes 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 active-minutes. 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 active minutes data to the Google Health API?

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

How do you aggregate active-minutes 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/active-minutes/dataPoints:rollUp) returns RollupDataPoint.activeMinutes, a ActiveMinutesRollupValue with activeMinutesRollupByActivityLevel; dailyRollUp (POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/active-minutes/dataPoints:dailyRollUp) returns DailyRollupDataPoint.activeMinutes, a ActiveMinutesRollupValue with activeMinutesRollupByActivityLevel. Each field is described on this page as the discovery document describes it.

Does the Google Health API send webhooks for active-minutes?

Yes. Google's data-types table marks active-minutes with webhook support, the webhooks guide lists it, and automatic subscriptions name it with the token WEBHOOK_DATA_TYPE_ACTIVE_MINUTES.

Other activity and fitness data types

All activity and fitness data types →

Sources checked

Google Health API data types — last updated 2026-10-06 · read 2026-10-17
Google Health API discovery document (v4) — revision 20261014 · read 2026-10-17
Scopes — last updated 2026-10-09 · read 2026-10-17

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