Business API

Appearance

List webhook delivery attempts​

GET
/v1/webhooks/{id}/deliveries

Requires WEBHOOKS_READ, granted by WEBHOOKS_WRITE (bundles)

Returns the attempts to deliver events to a webhook, newest first, with the total across all pages. A failed attempt explains why in errorCategory and errorMessage, and shows when it will be retried in nextRetryAt. Keys restricted to sub-accounts can't use this endpoint.

Parameters​

Path Parameters

id*

Webhook ID: the identifier returned when the webhook was created.

Type
string
Required
Example"0b8f5d2e-7a41-4c3b-9e6d-2f1a8c7b5e90"
Format
"uuid"

Query Parameters

skip

Number of attempts to skip, for paging.

Type
integer
Example0
Default
0
limit

Maximum number of attempts to return, up to 100.

Type
integer
Example100
Default
100

Responses​

OK

application/json
JSON
{
"items": [
{
"eventId": "6c2e9b41-3d7f-4a8e-b5c1-9f0a2d4e6b8c",
"eventType": "FIAT_DEPOSIT_CREDITED",
"attemptNumber": 2,
"responseStatus": 200,
"terminalState": "SUCCESS",
"createdAt": "2026-10-23T08:16:04.108392Z"
},
{
"eventId": "6c2e9b41-3d7f-4a8e-b5c1-9f0a2d4e6b8c",
"eventType": "FIAT_DEPOSIT_CREDITED",
"attemptNumber": 1,
"errorCategory": "TIMEOUT",
"errorMessage": "Your endpoint did not respond within the delivery timeout.",
"nextRetryAt": "2026-10-23T08:16:03.512874Z",
"createdAt": "2026-10-23T08:15:33.512874Z"
}
],
"total": 2,
"limit": 100,
"offset": 0
}

Samples​

Errors

HTTPErrorWhen
400-11INVALID_REQUESTThe webhook ID isn't a valid UUID, skip or limit isn't an integer, or limit is more than 100.
404-18121WEBHOOK_SUBSCRIPTION_NOT_FOUNDNo webhook with this ID exists for your business.

Plus the errors common to all signed endpoints.