Skip to navigation

List deliveries of a subscription

Returns the delivery attempts recorded for one subscription, newest first, plus statusCounts aggregated over the same date window (ignoring the status filter, so a UI can render counters).

When fromDate is omitted the window defaults to the last 7 days. Replays are hidden unless includeReplays=true.

Replaces the v1 route GET /v1/integrator/webhooks/{id}/deliveries.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

subscriptionIdstringRequired
Webhook subscription identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Query parameters

statusstringOptional

Filters by the result at your endpoint (pending, retrying, delivered, failed, paused, not_dispatched). success and exhausted are accepted as aliases of delivered and not_dispatched.

searchstringOptional

Free-text match over event id / event type.

fromDatedatetimeOptional

Start of the window (RFC 3339). Defaults to 7 days ago.

toDatedatetimeOptional

End of the window (RFC 3339). Defaults to now.

includeReplaysbooleanOptionalDefaults to false

When true, includes replayed deliveries in the list.

pageintegerOptional>=1Defaults to 1

1-based page number.

sizeintegerOptional<=200Defaults to 50
Page size. Values above 200 fall back to 50.

Response

Deliveries found.
itemslist of objects
totalinteger

Total matching the filters (not just this page).

pageinteger
sizeinteger
statusCountsmap from strings to integersOptional

Count per status over the date window, ignoring the status filter.

Errors

400
Bad Request Error
404
Not Found Error
500
Internal Server Error