Contents

StatusDeviceBatteryHealth

The device’s battery health.

Declaration

object StatusDeviceBatteryHealth

Properties

NameTypeDescription
device.power.battery-health Requiredstring

The battery health status, which has the following values:

  • non-genuine: The battery isn’t a genuine Apple battery.

  • normal: The battery is operating normally.

  • service-recommended: The system recommends battery service.

  • unknown: The system couldn’t determine battery health information.

  • unsupported: The device doesn’t support battery health reporting.

Available in iOS 17 and later on iPhone, iPadOS 18.4 and later on supported iPad models, and macOS 14.4 and later on a Mac with Apple silicon.

Discussion

For more information about battery health, see the following support articles:

Status item availability

Allowed in supervised enrollment

iOS, macOS, Shared iPad

Allowed in device enrollment

iOS, Shared iPad

Allowed in user enrollment

NA

Allowed in local enrollment

iOS, macOS, Shared iPad

Allowed in system scope

iOS, macOS, Shared iPad

Allowed in user scope

NA

See Also

Status Reports and Elements