Get one delivery, with the envelope we sent

GET

https://client.api.corpx.com/v1/webhooks/:subscriptionId/deliveries/:deliveryId

GET

/v1/webhooks/:subscriptionId/deliveries/:deliveryId

curl https://client.api.corpx.com/v1/webhooks/subscriptionId/deliveries/deliveryId \
     -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>"

{
  "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",
  "envelope": {},
  "hookdeck": {
    "requestId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
    "eventId": "8c1f6a2e-4d3b-4b9a-9f0e-1a2b3c4d5e6f",
    "events": [
      {}
    ],
    "attempts": [
      {}
    ]
  },
  "hookdeckError": "connection refused"
}

Returns a single delivery, including the outbound envelope when it was persisted (deliveries created before 2026-05 may not have one), and a best-effort hookdeck block with the individual attempts.

If the attempts cannot be fetched, the response is still 200 and carries hookdeckError instead of failing the request.

Authentication

AuthorizationBearer

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

Path parameters

subscriptionIdstringRequired

Webhook subscription identifier.

deliveryIdstringRequired

Delivery identifier. May contain slashes (e.g. del_qrcode/cash-in:...).

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.

Response

Delivery found.

deliveryIdstring

subscriptionIdstring

eventIdstring

statusstring

attemptsinteger

createdAtdatetime

eventTypestringOptional

Canonical event name. Inferred from eventId for deliveries recorded before it was persisted.

lastErrorstringOptional

Empty string when the delivery never failed.

hookdeckRequestIdstringOptional

Empty string when there is no request recorded at Hookdeck.

dispatchedAtdatetime or nullOptional

envelopemap from strings to anyOptional

The outbound payload we sent. Absent for deliveries recorded before 2026-05.

hookdeckobjectOptional

Best-effort enrichment with the individual attempts.

hookdeckErrorstringOptional

Present instead of (or alongside) hookdeck when the attempts could not be fetched. The request still answers 200.

Errors

400

Bad Request Error

404

Not Found Error

500

Internal Server Error