> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# phone_device_status

> Check whether a device is online, paused, and ready for work.

Returns a device's connectivity and readiness: online/offline, paused state, app version, device name and model, and `last_seen`. **Use it before starting work** - it is the fastest way to explain a task that will not start.

Read-only: it never changes device state.

## Parameters

<ParamField body="device_id" type="string">
  The device to check. Omit to use your default device.
</ParamField>

## Response

The status payload reports:

| Field                 | Meaning                                                   |
| --------------------- | --------------------------------------------------------- |
| Online/offline        | Whether the phone is currently reachable                  |
| Paused                | Whether new tasks are being rejected with `device_paused` |
| App version           | The AGI Android app build on the device                   |
| Device name and model | What hardware you are targeting                           |
| `last_seen`           | When the device last contacted the server                 |

## When to use it

* **Before a session or long workflow** - confirm the target is online and not
  paused.
* **When a task sits in `pending`** - an offline or busy device is the usual
  cause.
* **After `device_offline` or `queue_wait_exceeded`** - verify which device was
  selected and when it was last seen before retrying.

## Related

* [`list_devices`](/api-reference/tools/list-devices) - all devices at a glance
* [`phone_device_pause`](/api-reference/tools/phone-device-pause) / [`phone_device_resume`](/api-reference/tools/phone-device-resume) - control the paused state
* [`phone_get_state`](/api-reference/tools/phone-get-state) - full hardware/software snapshot