Skip to main content

List Webhook Deliveries

The List Webhook Deliveries endpoint returns the individual delivery attempts made to your signature webhook's URLs, newest first, with each attempt's status, HTTP response code, and retry count.

When to use it​

Use this endpoint to build a delivery log for debugging: find which attempts failed, filter to a specific event type, or locate a delivery's id to pass to Replay Webhook Delivery.

Example request​

curl "https://api.turbodocx.com/api/webhooks/signature/deliveries?limit=20&offset=0&isDelivered=false" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Accept: application/json"

Supported filters: eventType, isDelivered (true/false), and httpStatus (an exact status code). limit defaults to 20, offset to 0.

Known limitation: isDelivered=true and httpStatus do not currently filter results correctly due to a backend issue: isDelivered=true returns the same (undelivered-only) results as isDelivered=false, and httpStatus is ignored entirely regardless of value. Only isDelivered=false behaves as documented today.

Example response​

{
  "data": {
    "results": [
      {
        "id": "d3a1c2b4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
        "eventType": "signature.document.completed",
        "url": "https://example.com/webhooks/turbodocx",
        "httpStatus": 502,
        "responseBody": "Bad Gateway",
        "attemptCount": 2,
        "maxAttempts": 3,
        "isDelivered": false,
        "deliveredAt": null,
        "nextRetryAt": "2026-05-02T09:15:00.000Z",
        "errorMessage": "Request failed with status code 502",
        "status": "retrying",
        "createdOn": "2026-05-02T09:05:00.000Z",
        "updatedOn": "2026-05-02T09:10:00.000Z"
      }
    ],
    "totalRecords": 1,
    "limit": 20,
    "offset": 0
  }
}

status summarizes the row as "delivered", "failed" (all maxAttempts attempts exhausted), "retrying", or "pending". Failed deliveries retry automatically with backoff (immediate, then +1 minute, then +5 minutes) for up to maxAttempts (3) attempts total before landing in the dead-letter state.

Common errors​

StatusWhenResponse body
401Missing or invalid API key/token, or the organization cannot be resolvedEmpty (status only)
403The key's role is not administratorEmpty (status only)
404No webhook with that name exists in your organization{ "error": "Webhook not found" }
Last updated on