# Get the battery level — BoT GPS

Botize method — `bsize_bot.get_battery` (action).

Returns how much battery a BoT tag has left, and whether BoT is flagging it as needing a charge. It also returns when the tag last reported: a reading that keeps getting older is itself a sign that the tag has already died. Pair it with the clock trigger and a rule on 'Needs charging' to be warned before it runs out.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `did` *(string)* — Id of the BoT tag. Empty means the only tag in the account

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{device_id}}` *(text)* — Tag id
- `{{device_name}}` *(text)* — Tag name
- `{{battery_level}}` *(int)* — Battery (%). Charge left, from 0 to 100. Put a rule on this value to be warned early, for example below 20.
- `{{needs_charge}}` *(boolean)* — Needs charging. Yes when BoT itself is flagging the tag as needing a charge. It is BoT's own warning, so it fires late; for an early warning use the percentage instead.
- `{{updated_at}}` *(date)* — Reading date (UTC)
- `{{updated_ts}}` *(int)* — Reading date (epoch)
- `{{minutes_ago}}` *(int)* — Minutes since the reading. How old the reading is. Once the tag is out of battery it stops reporting, so this number keeps growing while the battery level stays frozen at its last value.

## Account

Needs a connected BoT GPS account in Botize: https://botize.com/en/app/bsize_bot/authenticate

## This app

Every trigger and action for BoT GPS: https://botize.com/en/app/bsize_bot.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/bsize_bot/get_battery