API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Devices

List the NextGen Android phones used as modems and their state

Use this to see which Android phones are attached, authorized and on the right app version. Rows are sorted by position and paged; total counts all rows. Each row is the phone's live record (fields vary by app version) plus auto_install, processing_disabled, target_swver and swver_mismatch. In Remote VPS mode rows also carry problem_reason and hw_serial, and enrolled phones that are offline get a row without position. Returns an empty list when NextGen Android support is off.

  • Read only
  • Basic auth
  • Panel API · since v20.9.48
  • Hub: routine call
  • listAndroidDevices
GET/androidng/list_device_info

Query parameters

pageintegeroptional

Page number, starting at 1.

Default 1Example 1
limitintegeroptional

Rows per page.

Default 10Example 10
showTypestringoptional

authorized lists only phones that accepted ADB authorization; anything else lists all.

One of all, authorizedDefault allExample all

Authentication

Needs dashboard Basic credentials when dashboard authentication is enabled; trusted callers (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) pass without them.

Responses

Phones.

dataobject[]required
data[].serialstringoptional
data[].positioninteger | nulloptional
data[].is_authorizedbooleanoptional
data[].swverstringoptional
data[].target_swverstringoptional
data[].swver_mismatchbooleanoptional
data[].auto_installbooleanoptional
data[].processing_disabledbooleanoptional
data[].connection_modestringoptional
data[].problem_reasonstring | nulloptional
data[].hw_serialstring | nulloptional
totalintegerrequired
Verified against XProxy v21.3.2 on Nov 17, 2026