Skip to main content
GET
Get a delivery
Returns a single delivery by ID. The response includes full debugging details: last_response_body (truncated to 4 KB), last_response_status, last_error, error_code, and resend_seq. Use this to diagnose why a delivery failed. Check last_response_status for HTTP errors, last_error for connection or timeout details, and error_code for stable alerting.
For usage patterns and examples, see the Webhooks guide: Debugging Deliveries.

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

id
string<uuid>
required

Delivery ID

Response

Delivery details

attempt_count
integer

Number of delivery attempts made so far

Example:

1

created_at
string<date-time>

When the delivery record was created

Example:

"2026-01-15T10:30:00Z"

delivered_at
string<date-time>

When the delivery was successfully completed

Example:

"2026-01-15T10:30:01Z"

error_code
string

Stable, machine-readable classification of the last failed attempt, e.g. consumer_response_timeout, consumer_5xx, rate_limited (omitted when none)

Example:

"consumer_response_timeout"

event_type
string

The event type (e.g. balance.credited)

Example:

"balance.credited"

id
string<uuid>

Delivery ID

Example:

"d1e2f3a4-b5c6-7890-abcd-ef1234567890"

last_attempt_at
string<date-time>

When the last attempt was made

Example:

"2026-01-15T10:30:01Z"

last_error
string

Error message from the last attempt (network errors, timeouts)

Example:

"connection timed out after 10s"

last_response_body
string

Response body from the last attempt (truncated to 4 KB)

Example:

"{\"received\":true}"

last_response_status
integer

HTTP status code from the last attempt

Example:

200

max_attempts
integer

Maximum attempts before marking as FAILED

Example:

8

next_attempt_at
string<date-time>

When the next delivery attempt is scheduled

Example:

"2026-01-15T10:30:00Z"

resend_seq
integer

Manual-resend sequence: 0 = the original delivery, 1,2,... = manual resends

Example:

0

status
string

Delivery status: PENDING, SENDING, DELIVERED, or FAILED

Example:

"DELIVERED"

updated_at
string<date-time>

When the delivery record was last updated

Example:

"2026-01-15T10:30:01Z"

webhook_endpoint_id
string<uuid>

The endpoint this delivery targets

Example:

"550e8400-e29b-41d4-a716-446655440000"

webhook_event_id
string<uuid>

The webhook event that triggered this delivery

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"