How can I access Keypad battery status / battery warning via API?

[DJMiro (Michael)]

Title: How can I access Keypad battery status / battery warning via API?

Hi,

we use two Nuki Keypads at one property: one is paired with a Nuki Smart Lock and the other one is paired with a Nuki Opener.

Nuki sends us an email when a Keypad battery is running low. However, neither the Nuki app nor our Home Assistant integration shows a battery level for either Keypad. There are also no Keypad battery entities available in Home Assistant.

As Nuki is clearly able to detect the low-battery condition and send the email notification, I assume this information must be available somewhere through the API.

Is there an API endpoint, field, webhook/event, or another supported way to retrieve:

• the current battery status/level of each paired Keypad, and
• a clear low-battery warning including which specific Keypad is affected?

We already use the Nuki API and would like to create a reliable Home Assistant notification before the batteries are empty.

Best regards
Michael

[andrew.oconnell]

Hi Michael,

Within the smartlock response, you’ll find a state array which contains batteryCritical, keypadBatteryCritical and doorsensorBatteryCritical. These values trigger at around 20% battery life of the respective smart lock or accessory. It’s the same conditional logic that is used to send the battery warning e-mails.

Check out the API documentation for more information on the battery charge state: General Examples | Nuki API

Kind regards,

Andrew