# Get Battery Status

Gets the values of battery from the terminal device.

Action available for the following operating systems:

![](/files/-MGIiDGuNcrVFP-DbUma)

### Parameters

*Battery*

* **AC Power Status** *\<unquoted string> -* The control or variable that saves the status of AC Power. If the terminal is plugged in to the electrical power the value is 1 - Online, if it is charging with an USB cable the value is 2 - Online\_USB, if the terminal isn't plugged in to the electrical power the value is 0 - Offline, otherwise the value is -1 - Unknow.
* **Battery Charge Status** *\<unquoted string> -* The control or variable that saves the status of the battery charge. Please see in the notes section the possible values for this parameter.
* **Remaining Battery (%)** *\<unquoted string> -* The control or variable that saves the value of the remaining battery in percentage. The value is "0%" to "100%" or "-1 - Unknow".
* **Remaining Battery (s)** *\<unquoted string> -* The control or variable that saves the value of the remaining battery in seconds. The value is "0 s" to "999999 s" or "-1 - Unknow".
* **Full Battery Seconds (s)** *\<unquoted string> -* The control or variable that saves the value of the full battery in seconds. The value is "0 s" to "999999 s" or "-1 - Unknow".

*Voltage*

* **Voltage (mV)** *\<unquoted string> -* The control or variable that saves the voltage of the battery. The possible values are from "0 mV" to "65,535 mV".
* **Current (mA)** *\<unquoted string> -* The control or variable that saves the current of the battery. The possible values are from "-32,768 mA" to "32,767 mA".
* **Average Current (mA)** *\<unquoted string> -* The control or variable that saves the average current of the battery. The possible values are from "-32,768 mA" to "32,767 mA".
* **Average Interval (ms)** *\<unquoted string> -* The control or variable that saves the time (in miliseconds) of integration used in reporting Average Current.
* **Current Consumed (mAH)** *\<unquoted string> -* The control or variable that saves the power consumed by the battery. The possible values are from "-32,768 mAH" to "0 mAH".

*Others*

* **Temperature (ºC)** *\<unquoted string> -* The control or variable that saves the temperature of the battery. The possible value are from "-3,276.8 ºC" to "3,276.8 ºC".
* **Chemestry** *\<unquoted string> -* The control or variable that saves the chemistry of the battery.

*Backup*\
(the following parameters refer to the Backup Battery)

* **Battery Charge Status** *\<unquoted string> -* The control or variable that saves the status of the backup battery charge. Please see in the notes section the possible values for this parameter.
* **Remaining Battery (%)** *\<unquoted string> -* The control or variable that saves the value of the remaining backup battery in percentage. The value is "0%" to "100%" or "-1 - Unknow".
* **Remaining Battery (s)** *\<unquoted string> -* The control or variable that saves the value of the remaining backup battery in seconds. The value is "0 s" to "999999 s" or "-1 - Unknow".
* **Full Battery Seconds (s)** *\<unquoted string> -* The control or variable that saves the value of the full backup battery in seconds. The value is "0 s" to "999999 s" or "-1 - Unknow".
* **Voltage (mV)** *\<unquoted string> -* The control or variable that saves the voltage of the backup battery. The possible values are from "0 mV" to "65,535 mV".

{% hint style="info" %}
The possible values for the parameter **Battery Charge Status** are:

* 1- High.
* 2 - Low.
* 3 - Critical.
* 4 - Charging.
* 5 - Charging/High.
* 6 - Charging/Low.
* 7 - Charging/Critical.
* 128 - No system battery.
* -1 - Unknow status.
  {% endhint %}

{% hint style="info" %}
Android client only reports **AC Power Status**, **Battery Charge Status**, **Remaining Battery %**, **Voltage** and **Temperature.**
{% endhint %}

{% hint style="info" %}
Win10 client only reports **Battery Charge Status** and **Remaining Battery %**
{% endhint %}

{% hint style="info" %}
iOS client only reports **AC Power Status**, **Battery Charge Status** and **Remaining Battery %**
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.sysdevmobile.com/kalipso5/developing/form/actions/actions-description/group-others/get-battery-status.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.