BasalMetabolicRateRecord: Health Connect basal metabolic rate data

What Google says BasalMetabolicRateRecord is

Captures the BMR of a user. Each record represents the energy a user would burn if at rest all day, based on their height and weight.

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

Class

androidx.health.connect.client.records.BasalMetabolicRateRecord

Google's category

Body Measurement

Record type

Instantaneous

Unit class

androidx.health.connect.client.units.Power

Mandatory fields

basalMetabolicRatemetadatatime

Added in (Jetpack)

1.1.0

Permissions

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

<uses-permission android:name="android.permission.health.READ_BASAL_METABOLIC_RATE" />
<uses-permission android:name="android.permission.health.WRITE_BASAL_METABOLIC_RATE" />

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

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

The 4 fields of BasalMetabolicRateRecord

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.

Aggregate metrics

The AggregateMetric constants Google defines on BasalMetabolicRateRecord. The value type is the T in Google’s AggregateMetric<T> signature. Every aggregate metric across all records.

Google’s read-data guide: “For cumulative types like StepsRecord, use aggregate() instead of readRecords() to avoid double counting from multiple sources and improve accuracy.” and “The aggregation API also contains logic to handle duplicate records, and lessens the chances of rate limiting.”

Read BasalMetabolicRateRecord in Kotlin

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

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

import androidx.health.connect.client.HealthConnectClient
import androidx.health.connect.client.records.BasalMetabolicRateRecord
import androidx.health.connect.client.request.AggregateRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant
import androidx.health.connect.client.units.Energy

suspend fun aggregateBasalMetabolicRate(
    client: HealthConnectClient,
    startTime: Instant,
    endTime: Instant,
): Energy? {
    val response = client.aggregate(
        AggregateRequest(
            metrics = setOf(BasalMetabolicRateRecord.BASAL_CALORIES_TOTAL),
            timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
        )
    )
    // get() is declared as returning a nullable value.
    return response[BasalMetabolicRateRecord.BASAL_CALORIES_TOTAL]
}

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 BasalMetabolicRateRecord 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.

• Body Composition API: Weight, Body Fat, and Lean Mass Data

Questions

What permission does BasalMetabolicRateRecord need?

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

Which aggregate metrics does BasalMetabolicRateRecord support?

Google's Jetpack reference defines 1 on BasalMetabolicRateRecord: BASAL_CALORIES_TOTAL (AggregateMetric<Energy>). Pass it in the metrics set of an AggregateRequest and read it back from the AggregationResult.

What values does BasalMetabolicRateRecord.basalMetabolicRate accept?

Google's reference types basalMetabolicRate as Power. Its description reads: "Basal metabolic rate, in Power unit. Required field. Valid range: 0-10000 kcal/day."

Is BasalMetabolicRateRecord an interval, instantaneous or series record?

Google's data-types table lists BasalMetabolicRateRecord as Instantaneous, and defines that column as indicating "whether the data is recorded at an instant in time or over an interval". Its mandatory fields are basalMetabolicRate, metadata and time.