Proxy Logs

Get proxy logs with optional filters and pagination

Changed on
get/proxy-logs

Request

  • 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

project_idinteger nullable

Filter by project ID

environment_idinteger nullable

Filter by environment ID

deployment_idinteger nullable

Filter by deployment ID

session_idinteger nullable

Filter by session ID

visitor_idinteger nullable

Filter by visitor ID

start_datestring date-time nullable

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_datestring date-time nullable

End date for filtering (ISO 8601 format). Defaults to now.

methodstring nullable

Filter by HTTP method (GET, POST, etc.)

hoststring nullable

Filter by host header

pathstring nullable

Filter by path (supports partial match)

path_exactstring nullable

Filter by an exact request path

client_ipstring nullable

Filter by client IP address

exclude_syntheticboolean nullable

Exclude Temps status-monitor requests, including legacy monitor rows identified only by their user-agent.

status_codeinteger nullable

Filter by HTTP status code

response_time_mininteger nullable

Filter by minimum response time in ms

response_time_maxinteger nullable

Filter by maximum response time in ms

routing_statusstring nullable

Filter by routing status (routed, no_project, error, pending)

request_sourcestring nullable

Filter by request source (proxy, api, console, cli)

is_system_requestboolean nullable

Filter by system request flag

user_agentstring nullable

Filter by user agent string (partial match)

browserstring nullable

Filter by browser name

operating_systemstring nullable

Filter by operating system

device_typestring nullable

Filter by device type (mobile, desktop, tablet)

is_botboolean nullable

Filter by bot detection

exclude_botsboolean nullable

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.

bot_namestring nullable

Filter by bot name

ai_providerstring nullable

Filter by AI provider (e.g. OpenAI, Anthropic, Perplexity). Matches the canonical provider returned by the AI agent detector.

ai_agentstring nullable

Filter by AI agent name (e.g. GPTBot, ChatGPT-User). Equivalent to filtering bot_name against a known AI taxonomy.

is_ai_agentboolean nullable

When true, only return requests classified as known AI agents (regardless of provider/agent). Mutually compatible with the above.

request_size_mininteger nullable

Filter by minimum request size in bytes

request_size_maxinteger nullable

Filter by maximum request size in bytes

response_size_mininteger nullable

Filter by minimum response size in bytes

response_size_maxinteger nullable

Filter by maximum response size in bytes

cache_statusstring nullable

Filter by cache status

container_idstring nullable

Filter by container ID

upstream_hoststring nullable

Filter by upstream host

has_errorboolean nullable

Filter by presence of error message

pageinteger nullable

Page number (default: 1)

page_sizeinteger nullable

Page size (default: 20, max: 100)

sort_bystring nullable

Sort by field (default: timestamp)

sort_orderstring nullable

Sort order (asc or desc, default: desc)

Response

List of proxy logs

pageinteger required
page_sizeinteger required
totalinteger required
total_pagesinteger required

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

    • 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