Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

List the attempts for a delivery Beta

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

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

Lists every attempt to deliver one event to one of your endpoints, oldest first: the first attempt, each automatic retry and each resend. Each attempt has its HTTP status code, your endpoint's response body (its first 4096 bytes) and how long it took. Returns at most the newest 50 attempts; truncated is true when there are more.

This page as markdownTriggers overview

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.
msg_idstringrequired
Message ID of the delivery, as returned in msg_id by List deliveries: msg_ followed by 1 to 64 letters or digits.

Response 200

attemptsarray of object
The delivery's attempts to this endpoint, oldest 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
truncatedboolean
True when the delivery has more than the 50 attempts returned. The newest 50 are returned, so the first attempt is missing when this is true.

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 -; msg_id is not a message ID (msg_ followed by 1 to 64 letters or digits); or the endpoint or the message does not exist in this environment
404Not found - Triggers isn't turned on for your environment
429Too many requests - deliveries are being read too often. Retry shortly; the request is not retried on your behalf
500Internal error - the attempts could not be read; retry the request