Get proxy logs with optional filters and pagination
Changed onRequest
- Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
- URL: /api/proxy-logs
- Auth: HTTP bearer
Query parameters
Filter by project ID
Filter by environment ID
Filter by deployment ID
Filter by session ID
Filter by visitor ID
Start date for filtering (ISO 8601 format).
Defaults to 1 hour before end_date (or before now) when omitted. The listing is always time-bounded: an unbounded query would have to consider the entire retention window — 100M+ rows on a busy deployment — to return a single page. Pass an explicit start_date to widen the window, up to the configured retention horizon.
The maximum span between start_date and end_date is 7 days when project_id is omitted, or 30 days when a single project_id is set — a project-scoped query is bounded by that project's own row count rather than the whole deployment's. A wider request is rejected with a 400 naming the applicable cap.
End date for filtering (ISO 8601 format). Defaults to now.
Filter by HTTP method (GET, POST, etc.)
Filter by host header
Filter by path (supports partial match)
Filter by an exact request path
Filter by client IP address
Exclude Temps status-monitor requests, including legacy monitor rows identified only by their user-agent.
Filter by HTTP status code
Filter by minimum response time in ms
Filter by maximum response time in ms
Filter by routing status (routed, no_project, error, pending)
Filter by request source (proxy, api, console, cli)
Filter by system request flag
Filter by user agent string (partial match)
Filter by browser name
Filter by operating system
Filter by device type (mobile, desktop, tablet)
Filter by bot detection
When true, exclude rows flagged as bots while KEEPING rows whose is_bot is NULL (older rows without detection metadata). This is the tri-state complement of is_bot=false, which matches only rows explicitly detected as non-bots. false/omitted is a no-op.
Filter by bot name
Filter by AI provider (e.g. OpenAI, Anthropic, Perplexity). Matches the canonical provider returned by the AI agent detector.
Filter by AI agent name (e.g. GPTBot, ChatGPT-User). Equivalent to filtering bot_name against a known AI taxonomy.
When true, only return requests classified as known AI agents (regardless of provider/agent). Mutually compatible with the above.
Filter by minimum request size in bytes
Filter by maximum request size in bytes
Filter by minimum response size in bytes
Filter by maximum response size in bytes
Filter by cache status
Filter by container ID
Filter by upstream host
Filter by presence of error message
Page number (default: 1)
Page size (default: 20, max: 100)
Sort by field (default: timestamp)
Sort order (asc or desc, default: desc)
Response
List of proxy logs
Changes
- info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status
- info
- warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status
- warning