# Get Battery Status

Gets the values of battery from the terminal device.

Action available for the following operating systems:

![](https://3821468174-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LrTlA1suFa5N48x_83N%2F-MGIW3wIXgRupIGNu8-p%2F-MGIiDGuNcrVFP-DbUma%2FTodos.PNG?alt=media\&token=406123c5-e2bb-4ec6-8044-9533b8686f6f)

### 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 %}