Skip to main content
GET
List deliveries
Returns the 50 most recent delivery attempts for a webhook, including your endpoint’s reply. This is the first place to look when a webhook is not arriving.

Authentication

Send your API key as a bearer token.
Any workspace role can read deliveries: admin, tech, or readonly.

Request

string
required
The webhook to list deliveries for.
This endpoint is not paginated. It always returns at most 50 records, newest first. There is no limit, page, or offset parameter.

Response

boolean
true when the request succeeded.
object[]
Delivery attempts, newest first. A webhook with no history returns [].
string
A human-readable summary.
Example response

Delivery statuses

Retry schedule

Encrata allows a delivery 4 attempts in total and waits 10 seconds for each one. If your endpoint returns a Retry-After header with a longer delay, Encrata honours it, up to a maximum of 15 minutes. After the fourth attempt the delivery is marked failed and is not retried.

Errors

Example error

Next steps

Send a test event

Reproduce a failure on demand.

Verify signatures

A 401 from your own handler usually means a signature mismatch.

Update a webhook

Point the webhook at a working URL.

Error reference

Every status code the API returns.