---
title: "List delivery attempts for a trigger endpoint"
method: GET
path: "/api/v1/trigger-delivery/endpoints/{endpoint_id}/attempts"
tags: ["Triggers"]
---

# List delivery attempts for a trigger endpoint

`GET /api/v1/trigger-delivery/endpoints/{endpoint_id}/attempts`

## Request

- Base URL: `https://$SCALEKIT_ENVIRONMENT_URL`
- URL: `https://$SCALEKIT_ENVIRONMENT_URL/api/v1/trigger-delivery/endpoints/{endpoint_id}/attempts`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://$SCALEKIT_ENVIRONMENT_URL/oauth/token`
- TypeScript: <https://skmtc.dev/scalekit/apis/scalekit-api-reference/docs/api/v1/trigger-delivery/endpoints/:endpoint_id/attempts/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the most recent attempts to deliver trigger events to one of the environment's trigger delivery endpoints, newest first. Use this endpoint to check whether trigger events reached your endpoint, and to inspect the HTTP status and response body each attempt received. Pass the delivery endpoint ID in the path, and optionally page_size, which defaults to 20 and is capped at 100. Only the most recent attempts are returned; there is no page token for older attempts. A failed attempt is retried, so check the newest attempt for a message before concluding it was not delivered. Returns the attempts, each with its status, the HTTP status code and response body your endpoint returned, the message ID, and the time of the attempt.

## Path parameters

- `endpoint_id` string, required

## Query parameters

- `page_size` integer

## Response `200`

The endpoint's most recent delivery attempts, newest first

- TriggersListTriggerDeliveryAttemptsByEndpointResponse
  - `attempts` TriggersTriggerDeliveryAttempt[]: The endpoint's most recent delivery attempts, newest first.
    - `endpoint_id` string: ID of the endpoint this attempt was made against.
    - `endpoint_url` string: URL this attempt was sent to.
    - `id` string: ID of this delivery attempt.
    - `msg_id` string: ID of the trigger event message this attempt delivered. Every attempt to deliver the same event shares this ID.
    - `response` string: Response body the endpoint returned for this attempt. A long body may be truncated.
    - `response_duration_ms` integer: How long the endpoint took to respond to this attempt, in milliseconds.
    - `response_status_code` integer: HTTP status code the endpoint returned for this attempt.
    - `response_truncated` boolean: True when `response` was cut to its first 4096 bytes. Set only by ListTriggerDeliveryAttemptsByMessage and LookupTriggerDelivery, which apply that cap.
    - `status` 'SUCCESS' | 'PENDING' | 'FAIL' | 'SENDING' | 'CANCELED': The outcome of one delivery attempt. - SUCCESS: The endpoint accepted the delivery. - PENDING: The attempt is waiting to be sent. - FAIL: The attempt failed. Failed deliveries are retried. - SENDING: The attempt is being sent. - CANCELED: The attempt was canceled and will not be sent.
    - `timestamp` string, date-time: When this attempt was made.
    - `trigger_type` 'TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_SCHEDULED' | 'TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_MANUAL': Why a delivery attempt was made. - TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_SCHEDULED: The first attempt or an automatic retry on the delivery schedule. - TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_MANUAL: A retry someone started by hand.

## Other responses

- `400`: Invalid request - endpoint_id is missing, is longer than 256 characters or contains characters other than letters, digits, `.`, `_` and `-`, or does not name a trigger delivery endpoint in this environment
- `404`: Not found - Triggers is not enabled for the environment
- `500`: Internal error - the delivery attempts 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/attempts/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)