Vo2MaxRecord: Health Connect VO2 max data

What Google says Vo2MaxRecord is

Capture user's VO2 max score and optionally the measurement method.

Quoted from Google’s Vo2MaxRecord Jetpack reference, last updated 2026-06-24, read 2026-10-03.

Class

androidx.health.connect.client.records.Vo2MaxRecord

Google's category

Activity

Record type

Instantaneous

Unit class

none named in Google's table

Mandatory fields

measurementMethodmetadatatimevo2MillilitersPerMinuteKilogram

Added in (Jetpack)

1.1.0

Permissions

The exact strings Google’s data-types table declares for Vo2MaxRecord. Google’s page: “Before requesting any permissions, your app must declare them in the manifest.”

<uses-permission android:name="android.permission.health.READ_VO2_MAX" />
<uses-permission android:name="android.permission.health.WRITE_VO2_MAX" />

import androidx.health.connect.client.permission.HealthPermission
import androidx.health.connect.client.records.Vo2MaxRecord

val permissions = setOf(
    HealthPermission.getReadPermission(Vo2MaxRecord::class),
    HealthPermission.getWritePermission(Vo2MaxRecord::class),
)

The 5 fields of Vo2MaxRecord

Types and descriptions as Google’s reference prints them. The range column quotes Google’s own range annotation or sentence; a dash means Google states none, which is not the same as no validation.

Constants

The 6 const val values Google’s reference lists on Vo2MaxRecord, with the integer each maps to.

Read Vo2MaxRecord in Kotlin

The shape of Google’s own read example, with Vo2MaxRecord and its names filled in. Get the client with HealthConnectClient.getOrCreate(context) after checking getSdkStatus.

import androidx.health.connect.client.HealthConnectClient
import androidx.health.connect.client.records.Vo2MaxRecord
import androidx.health.connect.client.request.ReadRecordsRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant

suspend fun readVo2Max(
    client: HealthConnectClient,
    startTime: Instant,
    endTime: Instant,
): List<Vo2MaxRecord> {
    val response = client.readRecords(
        ReadRecordsRequest(
            Vo2MaxRecord::class,
            timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
        )
    )
    // One page of up to pageSize records (default 1000); follow
    // response.pageToken for the rest.
    return response.records
}

Setting up the client, the permission flow and Play Console declaration: integrating Health Connect step by step.

HealthKit counterpart

The metric on other platforms

This guide lists Vo2MaxRecord beside the types on the other platforms this site covers whose own descriptions name the same metric, each quoted, with how each one is read.

• VO2 Max API: How to Get VO2 Max Data

Questions

What permission does Vo2MaxRecord need?

Google's Health Connect data-types table (read 2026-10-03) declares android.permission.health.READ_VO2_MAX for reading Vo2MaxRecord and android.permission.health.WRITE_VO2_MAX for writing it, and says apps must declare permissions in the manifest before requesting them.

Can you aggregate Vo2MaxRecord with AggregateRequest?

Not directly. As read on 2026-10-03, Google's Jetpack reference defines no AggregateMetric constants on Vo2MaxRecord, so there is no metric to put in an AggregateRequest. Read the records with readRecords and a ReadRecordsRequest, and compute any summary yourself.

What values does Vo2MaxRecord.vo2MillilitersPerMinuteKilogram accept?

Google's reference types vo2MillilitersPerMinuteKilogram as Double. Its description reads: "Maximal aerobic capacity (VO2 max) in milliliters. Required field. Valid range: 0-100."

What is the HealthKit equivalent of Vo2MaxRecord?

This site's verified cross-platform matrix pairs Vo2MaxRecord with HKQuantityTypeIdentifier.vo2Max in its VO2 max row. The caveat recorded with that pairing: An estimate on both platforms, not a lab measurement. Health Connect tags a measurement method.