BloodPressureRecord: Health Connect blood pressure data
Read from Google’s documentation on 2026-10-03 · Google’s reference page last updated 2026-06-24
BloodPressureRecord is Health Connect's blood pressure record — an Instantaneous record in Google's Vitals category. Its read permission is android.permission.health.READ_BLOOD_PRESSURE; its write permission is android.permission.health.WRITE_BLOOD_PRESSURE. It supports 6 aggregate metrics (DIASTOLIC_AVG, DIASTOLIC_MAX, DIASTOLIC_MIN and SYSTOLIC_AVG and more). Mandatory fields per Google's table: systolic, diastolic, bodyPosition, measurementLocation, metadata and time.
What Google says BloodPressureRecord is
Captures the blood pressure of a user. Each record represents a single instantaneous blood pressure reading.
Quoted from Google’s BloodPressureRecord Jetpack reference, last updated 2026-06-24, read 2026-10-03.
- Class
androidx.health.connect.client.records.BloodPressureRecord- Google's category
- Vitals
- Record type
- Instantaneous
- Unit class
androidx.health.connect.client.units.Pressure- Mandatory fields
systolicdiastolicbodyPositionmeasurementLocationmetadatatime- Added in (Jetpack)
1.1.0
Permissions
The exact strings Google’s data-types table declares for BloodPressureRecord. Google’s page: “Before requesting any permissions, your app must declare them in the manifest.”
| Access | Permission string | Framework reference |
|---|---|---|
| Read | android.permission.health.READ_BLOOD_PRESSURE | API 34 · U Ext 7 |
| Write | android.permission.health.WRITE_BLOOD_PRESSURE | API 34 · U Ext 7 |
<uses-permission android:name="android.permission.health.READ_BLOOD_PRESSURE" />
<uses-permission android:name="android.permission.health.WRITE_BLOOD_PRESSURE" />import androidx.health.connect.client.permission.HealthPermission
import androidx.health.connect.client.records.BloodPressureRecord
val permissions = setOf(
HealthPermission.getReadPermission(BloodPressureRecord::class),
HealthPermission.getWritePermission(BloodPressureRecord::class),
)The 7 fields of BloodPressureRecord
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.
| Field | Type | Allowed range | Google’s description |
|---|---|---|---|
bodyPositionmandatory= BODY_POSITION_UNKNOWN | Int | — | The user's body position when the measurement was taken. Optional field. Allowed values: BodyPosition. |
diastolicmandatory | Pressure | Valid range: 10-180mmHg. | Diastolic blood pressure measurement, in Pressure unit. Required field. Valid range: 10-180mmHg. For SDK extension 17 or higher, Valid range: 10-300mmHg. |
measurementLocationmandatory= MEASUREMENT_LOCATION_UNKNOWN | Int | — | The arm and part of the arm where the measurement was taken. Optional field. Allowed values: MeasurementLocation. |
metadatamandatory | Metadata | — | Set of common metadata associated with the written record. |
systolicmandatory | Pressure | Valid range: 20-200mmHg. | Systolic blood pressure measurement, in Pressure unit. Required field. Valid range: 20-200mmHg. For SDK extension 17 or higher, Valid range: 20-300mmHg. |
timemandatory | Instant | — | Time the record happened. |
zoneOffset | ZoneOffset? | — | User experienced zone offset at time, or null if unknown. Providing these will help history aggregations results stay consistent should user travel. Queries with user experienced time filters will assume system current zone offset if the information is absent. |
Aggregate metrics
The AggregateMetric constants Google defines on BloodPressureRecord. The value type is the T in Google’s AggregateMetric<T> signature. Every aggregate metric across all records.
| Metric | Value type | Google’s description |
|---|---|---|
| BloodPressureRecord.DIASTOLIC_AVG | Pressure | Metric identifier to retrieve average diastolic from androidx.health.connect.client.aggregate.AggregationResult. |
| BloodPressureRecord.DIASTOLIC_MAX | Pressure | Metric identifier to retrieve maximum diastolic from androidx.health.connect.client.aggregate.AggregationResult. |
| BloodPressureRecord.DIASTOLIC_MIN | Pressure | Metric identifier to retrieve minimum diastolic from androidx.health.connect.client.aggregate.AggregationResult. |
| BloodPressureRecord.SYSTOLIC_AVG | Pressure | Metric identifier to retrieve average systolic from androidx.health.connect.client.aggregate.AggregationResult. |
| BloodPressureRecord.SYSTOLIC_MAX | Pressure | Metric identifier to retrieve maximum systolic from androidx.health.connect.client.aggregate.AggregationResult. |
| BloodPressureRecord.SYSTOLIC_MIN | Pressure | Metric identifier to retrieve minimum systolic from androidx.health.connect.client.aggregate.AggregationResult. |
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.”
Constants
The 10 const val values Google’s reference lists on BloodPressureRecord, with the integer each maps to.
| Constant | Value | Google’s description |
|---|---|---|
BloodPressureRecord.BODY_POSITION_LYING_DOWN | 3 | — |
BloodPressureRecord.BODY_POSITION_RECLINING | 4 | — |
BloodPressureRecord.BODY_POSITION_SITTING_DOWN | 2 | — |
BloodPressureRecord.BODY_POSITION_STANDING_UP | 1 | — |
BloodPressureRecord.BODY_POSITION_UNKNOWN | 0 | — |
BloodPressureRecord.MEASUREMENT_LOCATION_LEFT_UPPER_ARM | 3 | — |
BloodPressureRecord.MEASUREMENT_LOCATION_LEFT_WRIST | 1 | — |
BloodPressureRecord.MEASUREMENT_LOCATION_RIGHT_UPPER_ARM | 4 | — |
BloodPressureRecord.MEASUREMENT_LOCATION_RIGHT_WRIST | 2 | — |
BloodPressureRecord.MEASUREMENT_LOCATION_UNKNOWN | 0 | — |
Read BloodPressureRecord in Kotlin
The shape of Google’s own read example, with BloodPressureRecord 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.BloodPressureRecord
import androidx.health.connect.client.request.ReadRecordsRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant
suspend fun readBloodPressure(
client: HealthConnectClient,
startTime: Instant,
endTime: Instant,
): List<BloodPressureRecord> {
val response = client.readRecords(
ReadRecordsRequest(
BloodPressureRecord::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.BloodPressureRecord
import androidx.health.connect.client.request.AggregateRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant
import androidx.health.connect.client.units.Pressure
suspend fun aggregateBloodPressure(
client: HealthConnectClient,
startTime: Instant,
endTime: Instant,
): Pressure? {
val response = client.aggregate(
AggregateRequest(
metrics = setOf(BloodPressureRecord.DIASTOLIC_AVG),
timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
)
)
// get() is declared as returning a nullable value.
return response[BloodPressureRecord.DIASTOLIC_AVG]
}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 BloodPressureRecord 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.
The metric on other platforms
This guide lists BloodPressureRecord 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.
Questions
- What permission does BloodPressureRecord need?
- Google's Health Connect data-types table (read 2026-10-03) declares android.permission.health.READ_BLOOD_PRESSURE for reading BloodPressureRecord and android.permission.health.WRITE_BLOOD_PRESSURE for writing it, and says apps must declare permissions in the manifest before requesting them.
- Which aggregate metrics does BloodPressureRecord support?
- Google's Jetpack reference defines 6 on BloodPressureRecord: DIASTOLIC_AVG (AggregateMetric<Pressure>), DIASTOLIC_MAX (AggregateMetric<Pressure>), DIASTOLIC_MIN (AggregateMetric<Pressure>), SYSTOLIC_AVG (AggregateMetric<Pressure>), SYSTOLIC_MAX (AggregateMetric<Pressure>) and SYSTOLIC_MIN (AggregateMetric<Pressure>). Pass them in the metrics set of an AggregateRequest and read each back from the AggregationResult.
- What values does BloodPressureRecord.diastolic accept?
- Google's reference types diastolic as Pressure. Its description reads: "Diastolic blood pressure measurement, in Pressure unit. Required field. Valid range: 10-180mmHg. For SDK extension 17 or higher, Valid range: 10-300mmHg."
- Is BloodPressureRecord an interval, instantaneous or series record?
- Google's data-types table lists BloodPressureRecord 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 systolic, diastolic, bodyPosition, measurementLocation, metadata and time.
Other Vitals records
Sources checked
- Google — BloodPressureRecord (Jetpack reference) — last updated 2026-06-24 · read 2026-10-03
- Google — Health Connect data types · read 2026-10-03
- Google — HealthPermissions (framework reference) · read 2026-10-03
- Google — Read raw data (Health Connect guide) · read 2026-10-03
Google’s descriptions are quoted for identification; the page layout, the capsule and the cross-platform pairing are AIFitnessAPI’s. Generated from Google’s pages by a script, not typed by hand — the same data is behind every page in the Health Connect reference.