Skip to main content
GET
Request counts over time
Returns request counts over time, split into successful, client-error and server-error responses, for the same filters you use to list request logs.
Same auth as the list: an API key with read:request-logs, or a session of an owner or admin with X-Organization-Id.

Query Parameters

Same filters as List Request Logs, without cursor and limit.

Bucket size

The bucket size depends on the length of the range: The rule: the smallest of 1, 5, 15, 60, 360 minutes that yields at most 200 buckets. Buckets are aligned to UTC and empty ones are returned as zeros.

Example Request

With a session, pass the organization as the second argument:

Example Response

Common Errors

400 Bad Request

Invalid from/to range (or more than 30 days), a filter with an unsupported value, or minDurationMs greater than maxDurationMs. Also returned when X-Organization-Id is missing on a session-authenticated request.

401 Unauthorized

Missing or invalid Bearer token / API key.

403 Forbidden

The authenticated user is not an owner or admin of the organization, or the API key does not have the read:request-logs scope.

Authorizations

X-API-Key
string
header
required

API Key for authentication (format: sk_...)

Headers

X-Organization-Id
string

Required for Supabase session auth (owner or admin). Ignored with an API key.

Query Parameters

from
string

Inicio (ISO 8601). Default: to - 24 h

to
string

Fin (ISO 8601). Default: ahora

status
string

Lista separada por comas de clases (2xx, 4xx, 5xx) y códigos exactos. Hasta 20.

Example:

"4xx,500"

method
string

Lista separada por comas de GET, POST, PUT, PATCH, DELETE.

Example:

"GET,POST"

q
string

Busca en el path real (contiene, sin distinguir mayúsculas).

Example:

"/invoices"

route
string
Example:

"/invoices/:uuid"

apiKeyId
string
environment
enum<string>
Available options:
sandbox,
production
channel
enum<string>
Available options:
web,
api,
sdk,
cli,
mcp
authFailure
enum<string>
Available options:
any,
inactive,
expired,
ip_not_allowed,
missing_scope
minDurationMs
number
Required range: 0 <= x <= 600000
maxDurationMs
number
Required range: 0 <= x <= 600000

Response

200 - application/json
from
string
required
Example:

"2026-10-13T17:00:00.000Z"

to
string
required
Example:

"2026-10-20T17:00:00.000Z"

bucketMinutes
enum<number>
required
Available options:
1,
5,
15,
60,
360
Example:

60

buckets
object[]
required