Skip to main content
GET
List Request Logs

Authorizations

Authorization
string
header
required

Short-lived access token from the device authorization flow. Expires after 15 minutes. Accesses only the environment of the client ID it was issued for.

Query Parameters

environment
enum<string>
required

The environment to read logs from. Must match your access token's environment.

Available options:
development,
production
Example:

"development"

start
string<date-time>

Return logs created on or after this timestamp, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Defaults to 24 hours before end. Must be no more than 7 days before end.

Example:

"2026-10-14T00:00:00Z"

end
string<date-time>

Return logs created on or before this timestamp, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Defaults to the current time.

Example:

"2026-10-15T00:00:00Z"

type
enum<string>

Return only API request logs (request) or only webhook delivery logs (webhook). Returns both if omitted.

Available options:
request,
webhook
Example:

"webhook"

session_id
string<uuid>

Return only logs for this session.

Example:

"915efe72-5136-4652-9a1f-d9d48003c102"

task_id
integer

Return only logs for this task.

Example:

7754123

external_user_id
string

Return only logs for this user.

Example:

"user-123"

event
string

Return only webhook logs for this event.

Example:

"AUTHENTICATED"

status_code
integer

Return only logs with this HTTP status code. For webhook logs, this is the status code your endpoint returned.

Required range: 100 <= x <= 599
Example:

400

limit
integer
default:25

Maximum number of logs to return.

Required range: 1 <= x <= 50
Example:

25

next_cursor
string

Cursor for the next page. Use the next_cursor value from the previous response and send the same filters, including start and end.

Example:

"eyJjcmVhdGVkX2F0IjoiMjAyNi0xMC0xNSAxNDozMTo1NSIsImlkIjo5ODIzMTcwMiwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ"

Response

Successful request.

data
object[]
required

Request logs, newest first.

next_cursor
string | null
required

Cursor for the next page, or null if there are no more logs.

limit
integer
required

Maximum number of logs returned per page.

Example:

25