List deliveries of a subscription

curl https://client.api.corpx.com/v1/webhooks/subscriptionId/deliveries \
     -H "X-Content-SHA256: X-Content-SHA256" \
     -H "X-Request-Signature: X-Request-Signature" \
     -H "X-Request-Timestamp: X-Request-Timestamp" \
     -H "X-Tenant-Id: X-Tenant-Id" \
     -H "Authorization: Bearer <token>"

{
  "items": [
    {
      "deliveryId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "subscriptionId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "eventId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "status": "COMPLETED",
      "attempts": 3,
      "createdAt": "2026-02-20T08:33:39Z",
      "eventType": "pix.in.completed",
      "lastError": "connection refused",
      "hookdeckRequestId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
      "dispatchedAt": "2026-02-20T08:33:39Z"
    }
  ],
  "total": 150,
  "page": 1,
  "size": 50,
  "statusCounts": {
    "key": 1
  }
}

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.

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-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.

Query parameters

statusstringOptional

Filters by delivery status (e.g. SUCCESS, FAILED, PENDING).

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