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

List connected proxies with ports, public IPs and modem details

Use this to discover which slots are online and which ports to use. Only slots whose modem has an active data connection are returned; empty or offline slots are left out. total counts all listed slots before paging. Paging applies only when both page and limit are valid integers.

  • Read only
  • Basic auth when API auth is on
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • getInfoList
GET/api/v1/info_list

Query parameters

pageintegeroptional

Page number, starting at 1. Ignored unless limit is also set.

limitintegeroptional

Rows per page. Ignored unless page is also set.

Authentication

Always needs a trusted caller: loopback, a LAN address (unless "force auth for local" is on), a whitelisted IP, an allowed Tailscale address, or valid dashboard Basic credentials (checked only when dashboard authentication is enabled).

Responses

Connected slots.

dataobject[]required
data[].positionintegeroptional

Slot number.

data[].hoststringoptional

Box address used in proxy strings.

data[].proxy_portintegeroptional

HTTP proxy port (IPv4).

data[].proxy_port_v6integer | nulloptional

HTTP proxy port (IPv6).

data[].socks5_portintegeroptional

SOCKS5 port (IPv4).

data[].socks5_port_ipv6integer | nulloptional

SOCKS5 port (IPv6).

data[].vless_portinteger | nulloptional

VLESS port when the license and box have it.

data[].vless_port_v6integer | nulloptional
data[].ss_portinteger | nulloptional

Shadowsocks port when the license and box have it.

data[].ss_port_v6integer | nulloptional
data[].public_ipstring | nulloptional

Current public IPv4.

data[].public_ip_ipv6string | nulloptional

Current public IPv6.

data[].last_rotationnumber | nulloptional

Unix time (seconds) of the latest rotation.

data[].last_updated_ipnumber | nulloptional

Unix time (seconds) of the latest public-IP check.

data[].device_manufacturestring | nulloptional

Modem type as detected by the box, e.g. HW-Hilink, Android, XLE.

data[].device_imeistring | nulloptional
data[].device_numberstring | nulloptional

SIM phone number when the modem reports it.

data[].device_ipstring | nulloptional

Modem address on the box side.

data[].device_rebootingboolean | nulloptional
data[].device_resettingboolean | nulloptional

True while a rotation runs.

data[].device_extra_infoobject | nulloptional

Modem-specific details (signal, provider, ...). Keys differ per modem type.

totalintegerrequired
Verified against XProxy v21.3.2 on Nov 17, 2026