--- title: "List trigger deliveries to an endpoint" method: GET path: "/api/v1/trigger-delivery/endpoints/{endpoint_id}/deliveries" tags: ["Triggers"] --- # List trigger deliveries to an endpoint `GET /api/v1/trigger-delivery/endpoints/{endpoint_id}/deliveries` ## Request - Base URL: `https://$SCALEKIT_ENVIRONMENT_URL` - URL: `https://$SCALEKIT_ENVIRONMENT_URL/api/v1/trigger-delivery/endpoints/{endpoint_id}/deliveries` - Auth: OAuth 2 - Client credentials - Token URL: `https://$SCALEKIT_ENVIRONMENT_URL/oauth/token` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Path parameters - `endpoint_id` string, required ## Query parameters - `page_size` integer - `page_token` string - `status` 'TRIGGER_DELIVERY_STATUS_DELIVERED' | 'TRIGGER_DELIVERY_STATUS_PENDING' | 'TRIGGER_DELIVERY_STATUS_FAILED' | 'TRIGGER_DELIVERY_STATUS_RETRYING' - `channel` string - `after` string, date-time - `before` string, date-time ## Response `200` One page of the endpoint's deliveries, newest first, with a next_page_token when older deliveries exist - TriggersListTriggerDeliveriesByEndpointResponse - `deliveries` TriggersTriggerDelivery[]: One page of the endpoint's deliveries that match the filters, newest first. - `connection_id` string: ID of the connection the event came from. Present even after the connection is deleted. Empty when the event carries none. - `connection_key_id` string: Key ID of the connection the event came from. Empty when the connection no longer exists. - `connection_provider` string: Provider of the connection the event came from. Empty when the connection no longer exists. - `endpoint_id` string: ID of the endpoint the event was delivered to. - `event_id` string: Event ID of the event: the payload's `dedupe_key` and `correlation_id`. Empty when the event was sent without one. - `message_timestamp` string, date-time: When the event was accepted for delivery. - `msg_id` string: Message ID of the event, sent to the endpoint as the `webhook-id` header. - `next_attempt_at` string, date-time: When the next attempt is scheduled. Present only while status is TRIGGER_DELIVERY_STATUS_RETRYING. - `status` 'TRIGGER_DELIVERY_STATUS_DELIVERED' | 'TRIGGER_DELIVERY_STATUS_PENDING' | 'TRIGGER_DELIVERY_STATUS_FAILED' | 'TRIGGER_DELIVERY_STATUS_RETRYING': The state of one trigger event's delivery to one endpoint, across all its attempts. The values carry the enum's name as a prefix because enum values share one namespace across this package, where PENDING and FAILED are already taken. - 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. - `subscription_id` string: ID of the trigger subscription that sent the event. Present even after the subscription is deleted. Empty when the event carries none. - `trigger_mode` 'WEBHOOK' | 'POLL': How a trigger detects that something happened. - WEBHOOK: The provider posts to a Scalekit URL when the event occurs. - POLL: Scalekit walks the provider's list on a cadence. - `trigger_name` string: Key of the trigger that fired, as the subscription was created with. Empty when the subscription no longer exists. - `next_page_token` string: 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. ## Other responses - `400`: Invalid request - endpoint_id is missing, is longer than 256 characters, contains characters other than letters, digits, `.`, `_` and `-`, or does not name a trigger delivery endpoint in this environment; status is not a known delivery status; channel is not a connection ID (`conn_`) or trigger subscription ID (`trgs_`) in this environment; `after` or `before` is not a valid timestamp, or `after` is later than `before`; or page_token is malformed or was issued for a different endpoint or set of filters - `404`: Not found - Triggers is not enabled for the environment - `429`: Too many requests - deliveries are being read too often. Retry shortly; the request is not retried on your behalf - `500`: Internal error - the deliveries could not be read; retry the request ## Changes - **2026-10-30** `f47f1022d844`: 1 info - endpoint added [Operation history](https://skmtc.dev/scalekit/apis/scalekit-api-reference/changes/api/v1/trigger-delivery/endpoints/:endpoint_id/deliveries/get.md) --- [API](https://skmtc.dev/scalekit/apis/scalekit-api-reference.md) - [All operations](https://skmtc.dev/scalekit/apis/scalekit-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/scalekit/apis/scalekit-api-reference/revisions/f47f1022d844?raw)