Proxy Logs

Get time-bucketed statistics with optional filters

Changed on
get/proxy-logs/stats/time-buckets

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/proxy-logs/stats/time-buckets
  • Auth: HTTP bearer

Query parameters

start_timestring required

Start time (ISO 8601 format)

end_timestring required

End time (ISO 8601 format)

bucket_intervalstring

Bucket interval (e.g., "1 hour", "1 day", "5 minutes"). Must keep span / interval ≤ 1000 buckets (7 days at 1 minute is rejected).

methodstring

Filter by HTTP method

client_ipstring

Filter by client IP

project_idinteger

Filter by project ID

environment_idinteger

Filter by environment ID

deployment_idinteger

Filter by deployment ID

hoststring

Filter by host

status_codeinteger

Filter by status code

status_code_classstring

Filter by status code class (e.g. "2xx", "3xx", "4xx", "5xx")

routing_statusstring

Filter by routing status

request_sourcestring

Filter by request source

is_botboolean

Filter by bot detection

device_typestring

Filter by device type

has_projectboolean

When true, only count requests that matched a project (project_id IS NOT NULL). Makes chart totals line up with the per-project health cards.

Response

Time-bucketed statistics

bucket_intervalstring required
end_timestring required
start_timestring required

Example response

{
  "stats": [
    {
      "bucket": "2025-10-23T12:00:00Z"
    }
  ]
}

Changes

  • 4b228ebed583Revision 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

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • 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

      removed the optional property from the response with the status