Skip to content
AF

HealthKit and Health Connect error codes

26 platform error codes · last fetched 2026-10-03

HealthKit reports failures as one of 17 HKError.Code cases; Health Connect’s platform API uses 9 HealthConnectException constants. Both references below are generated from the vendors’ own documentation, carry the vendor’s wording verbatim, and link to a fix guide where this site has one — 17 codes so far.

  • Every HealthKit error code

    All 17 HKError.Code cases with Apple's wording, why a denied read raises no error at all, and a fix guide for 15.

  • Health Connect error codes

    9 HealthConnectException constants with value and API level, plus the 6 exception types the Jetpack HealthConnectClient reference documents.

Related

Questions

Where do HealthKit and Health Connect define their error codes?

HealthKit's are the cases of HKError.Code — 17 of them on Apple's enum page as read on 2026-10-03. Health Connect's platform API defines 9 ERROR_* integer constants on android.health.connect.HealthConnectException. Apps using the Jetpack library meet a different surface: the HealthConnectClient reference documents 6 standard exception types rather than those constants.

Which platform publishes the numbers behind its error codes?

Google prints an integer value for all 9 Health Connect constants. Apple's pages carry no value for any of the 17 HKError.Code cases, so a HealthKit code number seen in a log cannot be looked up in Apple's documentation, while a Health Connect one can.

How current is this error code reference?

The error tables were last read from Apple's and Google's documentation on 2026-10-03, and the Health Connect release list on 2026-10-04. Each page prints its read date and how long ago that was. The tables are produced by scripts that refuse to publish if a source parses to fewer rows than the last verified read.