Trigger firings
Each time a trigger fired.
List trigger firings in the current workspace
GET
/v1/trigger-firingstrigger-firings.listParameters
Name
In
Type
Required
Description
Limit
In: query
integer (int32)
optional
Cursor
In: query
string
optional
TriggerId
In: query
integer (int64)
optional
Status
In: query
string
optional
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 200
data is a list of TriggerFiringModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
id
integer (int64)
triggerId
integer (int64)
campaignId
integer (int64)
contactId
integer (int64)
status
string
suppressionReason
string
attemptCount
integer (int32)
lastError
string
firedAt
string (date-time)
processedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/trigger-firings" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
"success": true,
"data": [
{
"id": 812,
"triggerId": 812,
"campaignId": 812,
"contactId": 812,
"status": "string",
"suppressionReason": "string",
"attemptCount": 1,
"lastError": "string",
"firedAt": "2026-09-23T15:02:11Z",
"processedAt": "2026-09-23T15:02:11Z"
}
],
"pagination": {
"nextCursor": "eyJpZCI6ODE1fQ",
"hasMore": true,
"total": 1,
"isTotalCapped": true
}
}