Listing the request logs

Note

The Admin API requires no token. The Admin API is typically protected at the network level.

Send the request as GET to the path /admin/v1/logs.

Description

Returns log entries in reverse-chronological order (newest first). All filters are optional and combinable.

Request

The following parameters are available:

Parameter	In	Type	Required	Description
tenant_id	query	string	no	Filter by tenant UUID.
gateway_id	query	string	no	Filter by gateway UUID.
provider	query	string	no	Filter by provider name (e.g. openai, anthropic).
model	query	string	no	Filter by model name.
status	query	integer	no	Filter by HTTP status code returned to the client (e.g. 200, 400, 429).
blocked	query	string	no	When true, return only blocked requests. When false, return only non-blocked requests.
since	query	string	no	Return entries at or after this time. Accepts ISO 8601 datetime or Unix milliseconds.
guardrail_outcome	query	string	no	Filter by guardrail outcome.
limit	query	integer	no	Maximum number of entries to return.
offset	query	integer	no	Skip this many entries (for pagination).

Example

Example of the response body:

{
  "logs": [
    {
      "id": "log_abc789",
      "ts": 1742547632000,
      "tenant": "myapp",
      "tenant_id": "ten_abc123"
    }
  ]
}

Responses

The endpoint answers the request with the following status codes:

Status code	Description
200	List of log entries.