Google Health API reference

VO2 Max: the Google Health API vo2-max 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

VO2 Max (vo2-max) is a Sample data type in the Google Health API. Google's data-types table lists list and reconcile for it under the .activity_and_fitness.readonly and .activity_and_fitness.writeonly scopes. The table marks it with neither webhook nor true-zeros support. Google's Fitbit migration table maps the Fitbit Web API's VO2 Max value data to it.

VO2 Max at a glance

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

Display name: VO2 Max
dataType (in endpoint URLs): vo2-max
filter parameter: vo2_maxGoogle: “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: Not marked in Google’s table
True zeros support: Not marked in Google’s table
Channel: v4
DataPoint field: DataPoint.vo2Max → VO2MaxIts description: “Optional. Data for points in the vo2-max sample data type collection.”
Compatible devices: 23 in Google’s table

Operations and request paths

The operations Google’s table lists for vo2-max, 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 vo2-max. 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/vo2-max/dataPoints`
`reconcile`	`reconcile`	`GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/vo2-max/dataPoints:reconcile`

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

Scopes

The scopes Google’s table lists for vo2-max, 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 VO2 Max

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

VO2Max — Google: “VO2 max measurement.”

Field	Type	Google’s description
`sampleTime`Required	`ObservationSampleTime`	Required. The time at which VO2 max was measured.
`vo2Max`Required	`number/double`	Required. VO2 max value measured as in ml consumed oxygen / kg of body weight / min. Must be in the range `[0, 100]`.
`measurementMethod`Optional	`string`	Optional. The method used to measure the VO2 max value. `MEASUREMENT_METHOD_UNSPECIFIED` — Unspecified measurement method. `FITBIT_RUN` — Fitbit specific, measures VO2 max rate during a run. `GOOGLE_DEMOGRAPHIC` — Google specific, measures VO2 max rate for a user based on their demographic data. `COOPER_TEST` — Run as far as possible for 12 minutes. Distance correlated with age and gender translates to a VO2 max value. `HEART_RATE_RATIO` — Maximum heart rate divided by the resting heart rate, with a multiplier applied. Does not require any exercise. `METABOLIC_CART` — Measured by a medical device called metabolic cart. `MULTISTAGE_FITNESS_TEST` — Continuous 20m back-and-forth runs with increasing difficulty, until exhaustion. `ROCKPORT_FITNESS_TEST` — Measured using walking exercise. `MAX_EXERCISE` — Healthkit specific, measures VO2 max rate by monitoring exercise to the user’s physical limit. Similar to COOPER_TEST or MULTISTAGE_FITNESS_TEST. `PREDICTION_SUB_MAX_EXERCISE` — Healthkit specific, estimates VO2 max rate based on low-intensity exercise. Similar to ROCKPORT_FITNESS_TEST. `PREDICTION_NON_EXERCISE` — Healthkit specific, estimates VO2 max rate without any exercise. Similar to HEART_RATE_RATIO. `OTHER` — Use when the method is not covered in this enum.

`ObservationSampleTime`

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

Field	Type	Google’s description
`physicalTime`Required	`string/google-datetime`	Required. The time of the observation.
`utcOffset`Required	`string/google-duration`	Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC).
`civilTime`Output only	`CivilDateTime`	Output only. The civil time in the timezone the subject is in at the time of the observation.

Fitbit Web API predecessor

Google’s Fitbit Web API → Google Health API data-type table maps VO2 Max value to vo2-max.

Fitbit Web API scopes Google maps to vo2-max’s scopes: activity, cardio_fitness.

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

Compatible devices

The 23 devices Google’s table lists as able to record and sync vo2-max.

Fitbit Air
Fitbit Alta HR
Fitbit Blaze
Fitbit Charge 2
Fitbit Charge 3
Fitbit Charge 4
Fitbit Charge 5
Fitbit Charge 6
Fitbit Inspire 2
Fitbit Inspire 3
Fitbit Ionic
Fitbit Luxe
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

VO2 Max in the v4 REST reference

Related on this site

VO2 Max API: How to Get VO2 Max Data — the metric on every platform this site covers, each type quoted in its platform's own words
Verification and rate limits
The Fitbit Web API turn-off

Questions

Which OAuth scopes does the Google Health API vo2-max 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 vo2-max. 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 VO2 max 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 vo2-max, and no create, update or batchDelete operation.

How do you aggregate vo2-max 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 vo2-max. Read the data points with list (or reconcile, where listed) and compute any summary yourself.

What did the Google Health API vo2-max data type replace in the Fitbit Web API?

Google's Fitbit Web API migration table maps the Fitbit Web API's "VO2 Max value" to vo2-max. 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 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
API specifications — last updated 2026-09-22 · 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