API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Stats & logs

Read recent proxy access log lines with filters

Use this to see which clients went where through the proxies, newest first. Reads back through rotated log files until lines entries match (default 20, at most 1000). Filters combine: position and port accept repeated values (position[]=1 or position=1), client_ip, client_username, target_host and method match partially, error_code matches exactly or error for any non-zero code, log_type is MAIN, SELL or GROUP; start_time/end_time are epoch seconds. Returns client IPs, usernames and visited hosts (personal data).

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

Query parameters

linesintegeroptional
Default 20Example 20
filter_logstringoptional

Free-text filter on the raw line.

position[]integer[]optional
port[]integer[]optional
client_ipstringoptional
client_usernamestringoptional
target_hoststringoptional
methodstringoptional
error_codestringoptional
log_typestringoptional
One of MAIN, SELL, GROUPExample MAIN
start_timeintegeroptional
end_timeintegeroptional

Responses

Matching log entries; on a read error the lists are empty.

statusbooleanoptional
msgstringoptional
dataobjectoptional
data.contentstringoptional

Raw lines joined by new lines.

data.parsedobject[]optional
data.total_filteredintegeroptional
data.total_parsedintegeroptional
Verified against XProxy v21.3.2 on Nov 17, 2026