NutritionRecord: Health Connect nutrition data

What Google says NutritionRecord is

Captures what nutrients were consumed as part of a meal or a food item.

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

Class

androidx.health.connect.client.records.NutritionRecord

Google's category

Nutrition

Record type

Interval

Unit class

androidx.health.connect.client.units.Mass

Mandatory fields

endTimemealTypemetadatastartTime

Added in (Jetpack)

1.1.0

Permissions

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

<uses-permission android:name="android.permission.health.READ_NUTRITION" />
<uses-permission android:name="android.permission.health.WRITE_NUTRITION" />

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

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

The 49 fields of NutritionRecord

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 NutritionRecord. 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 NutritionRecord in Kotlin

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

suspend fun readNutrition(
    client: HealthConnectClient,
    startTime: Instant,
    endTime: Instant,
): List<NutritionRecord> {
    val response = client.readRecords(
        ReadRecordsRequest(
            NutritionRecord::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.NutritionRecord
import androidx.health.connect.client.request.AggregateRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant
import androidx.health.connect.client.units.Mass

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

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

HealthKit counterpart

No verified HealthKit counterpart. The cross-platform matrix only pairs metrics checked against both Apple’s and Google’s documentation, and NutritionRecord is not among them yet. A similarly named Apple type may exist on the HealthKit reference, but a name match is not a verified mapping.

Questions

What permission does NutritionRecord need?

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

Which aggregate metrics does NutritionRecord support?

Google's Jetpack reference defines 42 on NutritionRecord: BIOTIN_TOTAL (AggregateMetric<Mass>), CAFFEINE_TOTAL (AggregateMetric<Mass>), CALCIUM_TOTAL (AggregateMetric<Mass>), CHLORIDE_TOTAL (AggregateMetric<Mass>), CHOLESTEROL_TOTAL (AggregateMetric<Mass>), CHROMIUM_TOTAL (AggregateMetric<Mass>), COPPER_TOTAL (AggregateMetric<Mass>), DIETARY_FIBER_TOTAL (AggregateMetric<Mass>), ENERGY_FROM_FAT_TOTAL (AggregateMetric<Energy>), ENERGY_TOTAL (AggregateMetric<Energy>), FOLATE_TOTAL (AggregateMetric<Mass>), FOLIC_ACID_TOTAL (AggregateMetric<Mass>), IODINE_TOTAL (AggregateMetric<Mass>), IRON_TOTAL (AggregateMetric<Mass>), MAGNESIUM_TOTAL (AggregateMetric<Mass>), MANGANESE_TOTAL (AggregateMetric<Mass>), MOLYBDENUM_TOTAL (AggregateMetric<Mass>), MONOUNSATURATED_FAT_TOTAL (AggregateMetric<Mass>), NIACIN_TOTAL (AggregateMetric<Mass>), PANTOTHENIC_ACID_TOTAL (AggregateMetric<Mass>), PHOSPHORUS_TOTAL (AggregateMetric<Mass>), POLYUNSATURATED_FAT_TOTAL (AggregateMetric<Mass>), POTASSIUM_TOTAL (AggregateMetric<Mass>), PROTEIN_TOTAL (AggregateMetric<Mass>), RIBOFLAVIN_TOTAL (AggregateMetric<Mass>), SATURATED_FAT_TOTAL (AggregateMetric<Mass>), SELENIUM_TOTAL (AggregateMetric<Mass>), SODIUM_TOTAL (AggregateMetric<Mass>), SUGAR_TOTAL (AggregateMetric<Mass>), THIAMIN_TOTAL (AggregateMetric<Mass>), TOTAL_CARBOHYDRATE_TOTAL (AggregateMetric<Mass>), TOTAL_FAT_TOTAL (AggregateMetric<Mass>), TRANS_FAT_TOTAL (AggregateMetric<Mass>), UNSATURATED_FAT_TOTAL (AggregateMetric<Mass>), VITAMIN_A_TOTAL (AggregateMetric<Mass>), VITAMIN_B12_TOTAL (AggregateMetric<Mass>), VITAMIN_B6_TOTAL (AggregateMetric<Mass>), VITAMIN_C_TOTAL (AggregateMetric<Mass>), VITAMIN_D_TOTAL (AggregateMetric<Mass>), VITAMIN_E_TOTAL (AggregateMetric<Mass>), VITAMIN_K_TOTAL (AggregateMetric<Mass>) and ZINC_TOTAL (AggregateMetric<Mass>). Pass them in the metrics set of an AggregateRequest and read each back from the AggregationResult.

What values does NutritionRecord.biotin accept?

Google's reference types biotin as Mass?. Its description reads: "Biotin in Mass unit. Optional field. Valid range: 0-100 grams."

Is NutritionRecord an interval, instantaneous or series record?

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