SCscalekit
Triggers

List trigger deliveries to an endpoint

Lists one page of the trigger events delivered to one delivery endpoint, newest first, with one entry per event however many attempts it took. Use this endpoint to check whether fired triggers reached your endpoint, and to find the deliveries that failed or are still being retried. Pass the delivery endpoint ID in the path. Narrow the list by delivery state (status), by the connection or trigger subscription the event came from (channel), and by time (after, before); page_size defaults to 20 and is capped at 100. Deliveries are kept for 90 days, so a time range reaching further back is cut to that window, and a range wholly outside it returns an empty page. Pass next_page_token back as page_token, with the same endpoint and filters, to read older deliveries. Each delivery returns its message ID, event ID, state and, while it is being retried, the time of its next attempt, and names the trigger subscription, trigger, detection mode and connection it came from while they still exist. Read the attempts behind one delivery with ListTriggerDeliveryAttemptsByMessage. The event payload is never returned.

get/api/v1/trigger-delivery/endpoints/{endpoint_id}/deliveries

Request

Path parameters

endpoint_idstring required

ID of the trigger delivery endpoint to list deliveries for. 1-256 characters.

Query parameters

page_sizeinteger

Maximum number of deliveries to return, newest first. Defaults to 20 when omitted or zero; a larger value than 100 is capped at 100 rather than refused.

page_tokenstring

The next_page_token from a previous response, to read the next page of older deliveries. Omit it to read the newest page. A token is bound to the environment, the endpoint and the filters it was issued with: a token sent with a different endpoint or different filters is refused rather than mixing two result sets. At most 1024 characters.

status'TRIGGER_DELIVERY_STATUS_DELIVERED' | 'TRIGGER_DELIVERY_STATUS_PENDING' | 'TRIGGER_DELIVERY_STATUS_FAILED' | 'TRIGGER_DELIVERY_STATUS_RETRYING'

Narrows the list to deliveries in this state. Omit it, or send TRIGGER_DELIVERY_STATUS_UNSPECIFIED, for every state.

  • TRIGGER_DELIVERY_STATUS_DELIVERED: An attempt succeeded. No further attempt is made.
  • TRIGGER_DELIVERY_STATUS_PENDING: Accepted for delivery; no attempt has finished yet.
  • TRIGGER_DELIVERY_STATUS_FAILED: Every scheduled attempt failed. No further attempt is made unless one is started by hand.
  • TRIGGER_DELIVERY_STATUS_RETRYING: An attempt failed and another is scheduled, at next_attempt_at.
channelstring

Narrows the list to deliveries of events from one connection (a conn_ ID) or one trigger subscription (a trgs_ ID). The ID must exist in this environment; any other value is refused with 400. At most 64 characters.

afterstring date-time

Only deliveries of events created after this instant. Omit it to read back to the oldest retained delivery. Deliveries are kept for 90 days, so a value earlier than that is moved forward to the start of the retained window. Refused when later than before. Read to the second.

beforestring date-time

Only deliveries of events created before this instant. Omit it to start from the newest delivery. A value later than the current time is treated as the current time. With after, reads a time range; the list stays newest first within it. Read to the second.

Response

One page of the endpoint's deliveries, newest first, with a next_page_token when older deliveries exist

next_page_tokenstring

Pass this as page_token, with the same endpoint_id and filters, to read the next page of older deliveries. Empty when there are no older deliveries.

Example response

{
  "deliveries": [
    {
      "connection_id": "conn_28128748834787840",
      "connection_key_id": "slack-acme",
      "connection_provider": "SLACK",
      "endpoint_id": "ep_2yAqUuFkqbL5nXvC7HhWJRY6Gg9",
      "event_id": "ca_5F28128748834787840.trgs_5F28128748834787841.Ev07ABCDEF12",
      "message_timestamp": "2026-10-09T12:34:55Z",
      "msg_id": "msg_2yAqUxVq4mTt8jHZ3fWbKcN1Pd0",
      "next_attempt_at": "2026-10-09T12:39:56Z",
      "subscription_id": "trgs_28128748834787841",
      "trigger_name": "slack_message_posted"
    }
  ],
  "next_page_token": "<next_page_token>"
}

Changes