OxygenSaturationRecord: Health Connect oxygen saturation data

What Google says OxygenSaturationRecord is

Captures the amount of oxygen circulating in the blood, measured as a percentage of oxygen-saturated hemoglobin. Each record represents a single blood oxygen saturation reading at the time of measurement.

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

Class

androidx.health.connect.client.records.OxygenSaturationRecord

Google's category

Vitals

Record type

Instantaneous

Unit class

none named in Google's table

Mandatory fields

metadatapercentagetime

Added in (Jetpack)

1.1.0

Permissions

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

<uses-permission android:name="android.permission.health.READ_OXYGEN_SATURATION" />
<uses-permission android:name="android.permission.health.WRITE_OXYGEN_SATURATION" />

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

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

The 4 fields of OxygenSaturationRecord

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.

Read OxygenSaturationRecord in Kotlin

The shape of Google’s own read example, with OxygenSaturationRecord 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.OxygenSaturationRecord
import androidx.health.connect.client.request.ReadRecordsRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant

suspend fun readOxygenSaturation(
    client: HealthConnectClient,
    startTime: Instant,
    endTime: Instant,
): List<OxygenSaturationRecord> {
    val response = client.readRecords(
        ReadRecordsRequest(
            OxygenSaturationRecord::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 OxygenSaturationRecord 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.

• Blood Oxygen (SpO2) API: How to Get SpO2 Data

Questions

What permission does OxygenSaturationRecord need?

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

Can you aggregate OxygenSaturationRecord with AggregateRequest?

Not directly. As read on 2026-10-03, Google's Jetpack reference defines no AggregateMetric constants on OxygenSaturationRecord, 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 OxygenSaturationRecord.percentage accept?

Google's reference types percentage as Percentage. Its description reads: "Percentage. Required field. Valid range: 0-100."

What is the HealthKit equivalent of OxygenSaturationRecord?

This site's verified cross-platform matrix pairs OxygenSaturationRecord with HKQuantityTypeIdentifier.oxygenSaturation in its Blood oxygen row. The caveat recorded with that pairing: The type existing doesn't mean data exists — SpO2 is device-gated, and Apple Watch availability in the US has been subject to litigation. Verify current status.