- API Reference
- Box API
- 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).
/v2/proxy_logQuery parameters
20Example 20Free-text filter on the raw line.
MAIN, SELL, GROUPExample MAINResponses
Matching log entries; on a read error the lists are empty.
Raw lines joined by new lines.
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.