restingHeartRate: HealthKit quantity type
HKQuantityTypeIdentifierRestingHeartRate · read from Apple’s documentation on 2026-10-02
HKQuantityTypeIdentifier.restingHeartRate (Objective-C HKQuantityTypeIdentifierRestingHeartRate) is a HealthKit quantity type in Apple's "Vital signs" group. Apple's abstract: “A quantity sample type that measures the user’s resting heart rate.” Apple's discussion says its samples use count/time units and measure discrete values, so in HKStatisticsQuery it takes .discreteAverage, .discreteMin or .discreteMax. It is available from iOS 11.0 and watchOS 4.0. This site's verified cross-platform matrix lists it in its Heart rate row, beside HeartRateRecord, RestingHeartRateRecord on Android Health Connect, with the caveat “Both expose samples plus a separate resting value — don't derive resting yourself.”
What Apple says restingHeartRate is
A quantity sample type that measures the user’s resting heart rate.
Apple’s abstract, quoted from its restingHeartRate reference page, read 2026-10-02. Apple’s discussion of the type runs 176 words.
- Swift
HKQuantityTypeIdentifier.restingHeartRate- Objective-C
HKQuantityTypeIdentifierRestingHeartRate- Family
HKQuantityTypeIdentifier- Apple's topic group
- Vital signs
- Group page
- Vital signs
- Apple's reference
- restingHeartRate on developer.apple.com
Availability
The versions Apple’s documentation data gives for restingHeartRate, platform by platform, as read on 2026-10-02.
| Platform | Introduced | Deprecated |
|---|---|---|
| iOS | 11.0 | — |
| iPadOS | 11.0 | — |
| Mac Catalyst | 13.0 | — |
| macOS | 13.0 | — |
| visionOS | 1.0 | — |
| watchOS | 4.0 | — |
The rest of that release: HealthKit Types Introduced in iOS 11.
Sum or average, and in which units
Apple states both of these in the prose of the type’s discussion, not as properties, so they are derived from Apple’s sentence and the sentence is shown with each.
Aggregation style
discrete — in an HKStatisticsQuery, use .discreteAverage, .discreteMin or .discreteMax. Apple’s sentence:
These samples use count/time units (described in ) and measure discrete values (described in ).
Unit family
count/time — every type in this family is on the HKUnit reference.
Apple states it in the same sentence as the aggregation style, quoted above.
Empty parentheses and a dangling “described in” mark links in Apple’s sentence to other documentation pages: the generator keeps the sentence’s text, not its links, and the quote is left as stored rather than repaired.
Can apps write restingHeartRate?
Apple’s documentation for restingHeartRate does not state that its samples are read-only. Apple states read-only status only in prose, and its silence is not a statement either way, so this page makes no claim that apps can save it.
On Android Health Connect
restingHeartRate sits in the verified cross-platform matrix’s Heart rate row, which names HKQuantityTypeIdentifier.heartRate, .restingHeartRate on Apple and HeartRateRecord, RestingHeartRateRecord on Android. The row groups the metric; it does not pair each Apple type with one Android record.
Both expose samples plus a separate resting value — don't derive resting yourself.
The metric guide for this row: Heart rate on every platform.
Questions
- Should I sum or average restingHeartRate in HealthKit?
- Average it, or take its minimum or maximum — do not sum it. Apple's documentation for restingHeartRate describes it as measuring discrete values, so an HKStatisticsQuery over it takes .discreteAverage, .discreteMin or .discreteMax. Apple's sentence, as read on 2026-10-02: "These samples use count/time units (described in ) and measure discrete values (described in )."
- Which unit family does Apple give restingHeartRate?
- Count/time. Apple's discussion of restingHeartRate says its samples use count/time units: "These samples use count/time units (described in ) and measure discrete values (described in )."
- Does restingHeartRate have a Health Connect equivalent?
- This site's verified cross-platform matrix lists restingHeartRate in its Heart rate row, which groups HKQuantityTypeIdentifier.heartRate, .restingHeartRate on Apple with HeartRateRecord, RestingHeartRateRecord on Android; the row groups the metric and does not pair each Apple type with one Android record. The caveat recorded with that row: Both expose samples plus a separate resting value — don't derive resting yourself.
- Which iOS version added restingHeartRate?
- iOS 11.0. Apple's availability data for restingHeartRate lists iOS 11.0, iPadOS 11.0, Mac Catalyst 13.0, macOS 13.0, visionOS 1.0 and watchOS 4.0.
Sources checked
- Apple — HKQuantityTypeIdentifier.restingHeartRate · read 2026-10-02
- Apple — HKQuantityTypeIdentifier · read 2026-10-02
Apple’s abstract and sentences are quoted for identification; the page layout, the capsule and the cross-platform pairing are AIFitnessAPI’s. Generated from Apple’s documentation by scripts/fetch-healthkit-identifiers.mjs, not typed by hand — the same data as the full identifier table.