Skip to main content
GET
List integration delivery logs

Authorizations

Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_), used exactly as shown in the dashboard. Endpoints that support sandbox data take an explicit environment field or parameter. All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Query Parameters

limit
integer
default:20

Maximum number of log entries to return.

Required range: 1 <= x <= 100
offset
integer
default:0

Number of log entries to skip.

Required range: 0 <= x <= 100000
sort_by
enum<string>
default:created_at

Field to sort by.

Available options:
track_event_id,
target_id,
success,
failed_code,
updated_at,
created_at
sort_order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
filter[track_event_id]
string

Comma-separated track event IDs to filter by (max 50).

filter[target_id]
string

Comma-separated target IDs to filter by (max 50). A target is an app in the project, not the integration the event was delivered to.

filter[success]
enum<string>

Filter by delivery outcome. Note the response field is is_success.

Available options:
true,
false
from
integer<int64>

Start of the time range (Unix timestamp, seconds). The window between from and to can be at most 24 hours wide; a wider window is rejected with 400. Omit both from and to to get the last 24 hours. Given alone, to defaults to the current time, so from alone works only for a point within the last 24 hours. To read further back, request consecutive 24-hour windows.

Required range: x >= 0
to
integer<int64>

End of the time range (Unix timestamp, seconds). Given alone, from defaults to to minus 24 hours. With both ends set, to can be at most 24 hours after from.

Required range: x >= 0

Response

A list of integration delivery log entries.

object
string
Example:

"list"

url
string
Example:

"/v4/event-logs"

data
object[]
has_more
boolean
Example:

false

total_count
integer

Total number of matching log entries.

Example:

42