List recent delivery attempts Beta

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

This endpoint is in beta. Its request and response may change.

Lists the most recent attempts to deliver trigger events to one of your endpoints, newest first, up to page_size (default 20, at most 100). There's no page token for older attempts. A failed attempt is retried, so check the newest attempt for an event before you decide it wasn't delivered.

This page as markdown Triggers overview

REST
Python

Authorization

Authorization: Bearer $TOKEN, an access token from the client credentials grant. See Authentication.

Path parameters

endpoint_idstringrequired

ID of your delivery endpoint (ep_...), the URL on your server that you added under Developers > Trigger Delivery. Look up a delivery returns it as endpoint_id on each attempt.

Query parameters

page_sizeinteger

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

scalekit_client.actions.triggers.list_delivery_attempts_by_endpoint

List the most recent attempts to deliver trigger events to one of your endpoints.

scalekit_client.actions.triggers.list_delivery_attempts_by_endpoint(
    endpoint_id: str,
    page_size: int | None = None,
) -> ListTriggerDeliveryAttemptsByEndpointResponse

Parameters

endpoint_idstrrequired

ID of your delivery endpoint (ep_...), the URL on your server that you added under Developers > Trigger Delivery. Look up a delivery returns it as endpoint_id on each attempt.

page_sizeint | None

Attempts to return; the server default is 20, capped at 100.

Returns ListTriggerDeliveryAttemptsByEndpointResponse: The attempts (one page; there is no page token).

From scalekit-sdk-python 2.23.0.

Response 200

attemptsarray of object

The endpoint's most recent delivery attempts, newest first.

Show 11 child attributes

endpoint_idstring

ID of the endpoint this attempt was made against.

endpoint_urlstring

URL this attempt was sent to.

idstring

ID of this delivery attempt.

msg_idstring

ID of the trigger event message this attempt delivered. Every attempt to deliver the same event shares this ID.

responsestring

Response body the endpoint returned for this attempt. A long body may be truncated.

response_duration_msinteger

How long the endpoint took to respond to this attempt, in milliseconds.

response_status_codeinteger

HTTP status code the endpoint returned for this attempt.

response_truncatedboolean

True when response was cut to its first 4096 bytes. Set only by List the attempts for a delivery and Look up a delivery, which apply that cap.

statusstring (enum)

Whether this attempt succeeded, is still in flight, failed, or was canceled. A failed delivery is retried, so FAIL on one attempt does not mean the event was never delivered — check the newest attempt for that message.

SUCCESSPENDINGFAILSENDINGCANCELED

timestampstring

When this attempt was made.

trigger_typestring (enum)

Why this attempt was made: TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_SCHEDULED for the first attempt or an automatic retry, TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_MANUAL for a retry someone started by hand.

TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_SCHEDULEDTRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_MANUAL

Errors

Every error has the same body: code, message and details. See Errors and rate limits.

400Invalid 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

404Not found - Triggers isn't turned on for your environment

500Internal error - the delivery attempts could not be read; retry the request

Request

REST
Python

curl -sS -G -X GET \
  "$SCALEKIT_ENVIRONMENT_URL/api/v1/trigger-delivery/endpoints/ep_2qGv8XHk3mT5bJr9LwNc7pZeYfA/attempts" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "page_size=20"

result = scalekit_client.actions.triggers.list_delivery_attempts_by_endpoint(
    endpoint_id="ep_2qGv8XHk3mT5bJr9LwNc7pZeYfA",
    page_size=20,
)

Response 200

1
{
2
  "attempts": [
3
    {
4
      "id": "atmpt_2qGvA2bNf7KcW4xRm8TjP5sLhYd",
5
      "msg_id": "msg_2qGvA1sKd8RtY6nWm3LpX9cBhVe",
6
      "endpoint_id": "ep_2qGv8XHk3mT5bJr9LwNc7pZeYfA",
7
      "endpoint_url": "https://api.example.com/scalekit/triggers",
8
      "status": "SUCCESS",
9
      "response_status_code": 200,
10
      "response": "{\"ok\":true}",
11
      "response_truncated": false,
12
      "response_duration_ms": 84,
13
      "timestamp": "2026-10-28T09:17:45.020Z",
14
      "trigger_type": "TRIGGER_DELIVERY_ATTEMPT_TRIGGER_TYPE_SCHEDULED"
15
    }
16
  ]
17
}