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

List every slot with ports, IP state, schedules and Smart IP Guard data

Use this for the full panel view of all slots, including offline and stopped ones (unlike /api/v1/info_list, which lists only connected slots). Paging is 1-based; limit 0 returns every row. search filters rows by text match before paging; total counts the filtered rows. Returns secrets: each row carries the slot's VLESS id and Shadowsocks password.

  • Read only
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: routine call
  • getPanelProxyList
GET/v2/proxy_list

Query parameters

pageintegeroptional

Page number starting at 1. A non-integer value fails with HTTP 500.

Default 1Example 1
limitintegeroptional

Rows per page; 0 returns all rows.

Default 10Example 10
searchstringoptional

Free-text filter on the slot fields (port, IP, label, modem type).

Authentication

Needs the panel login; the API policy additionally requires credentials or a trusted caller (loopback, LAN, whitelist, allowed Tailscale).

Responses

Slots on the requested page.

dataobject[]optional
data[].positionintegeroptional

Slot number, starting at 1.

data[].proxy_portinteger | nulloptional
data[].socks5_portinteger | nulloptional
data[].vless_portinteger | nulloptional
data[].ss_portinteger | nulloptional
data[].vless_uuidstringoptional

VLESS client id of the slot (secret). Present only when the slot has a VLESS port.

data[].ss_passwordstring | nulloptional

Shadowsocks password of the slot (secret); null when Shadowsocks is off or not licensed.

data[].public_ipstring | nulloptional

Current public IPv4; null when offline or stopped.

data[].public_ip_v6string | nulloptional
data[].manustring | nulloptional

Modem type, for example HW-Hilink, QMI, XH22 or Android.

data[].ip_statusstringoptional

Computed connection state of the slot.

One of empty, stopped, rotating, disconnected, duplicate, connected
data[].rebootingbooleanoptional
data[].extra_infoobjectoptional

Modem details; apn is reduced to the APN name and Wi-Fi/IMEI data is removed.

data[].rotation_jobsintegeroptional

Number of scheduled rotation jobs on the slot.

data[].rotation_next_runnumber | nulloptional

Epoch seconds of the next scheduled rotation.

data[].ip_scoreintegeroptional

Smart IP Guard score of the current IP (0-100). Present when the guard exists.

data[].repeatsintegeroptional
data[].freshnessstringoptional
data[].stoppedbooleanoptional

True when the slot was auto-stopped or stopped by the user.

data[].stopped_bystring | nulloptional
data[].stopped_atnumber | nulloptional
data[].disconnectbooleanoptional
totalintegeroptional
ip_history_guard_enabledbooleanoptional
auto_resume_secondsintegeroptional
Verified against XProxy v21.3.2 on Nov 17, 2026