Contents

StatusDeviceBatteryHealth

The status item that reports 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.

Supported on iPhones, specific iPad models, and Mac computers 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

N/A

Allowed in local enrollment

iOS, macOS, Shared iPad

Allowed in system scope

iOS, macOS, Shared iPad

Allowed in user scope

N/A

Status item example

{
    "device": {
        "power": {
            "battery-health": "normal"
        }
    }
}

See Also

Device property items