Skip to main content

Get Webhook Stats

The Get Webhook Stats endpoint returns delivery statistics for this specific webhook over a time window you choose, broken down by event type. Unlike the deliveryStats on Get Webhook (which cover your whole organization's last 30 days), this endpoint is scoped to one webhook and lets you pick the window.

When to use it​

Use this endpoint to build a delivery health dashboard for a single webhook: overall success rate, average response time, and which event types are failing most, over a period you control.

Example request​

curl "https://api.turbodocx.com/api/webhooks/signature/stats?days=7" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Accept: application/json"

days defaults to 30 and accepts 1 to 365.

Example response​

{
  "data": {
    "webhook": {
      "id": "b7e2c4a1-3f9d-4e6a-8c1b-5d0f7a2e9c34",
      "name": "signature",
      "isActive": true,
      "events": ["signature.document.completed", "signature.document.voided"],
      "urls": ["https://example.com/webhooks/turbodocx"]
    },
    "period": { "days": 7, "from": "2026-04-25T00:00:00.000Z", "to": "2026-05-02T00:00:00.000Z" },
    "summary": {
      "totalDeliveries": 42,
      "successfulDeliveries": 40,
      "failedDeliveries": 1,
      "pendingRetries": 1,
      "successRate": 95.24,
      "avgResponseTime": 184,
      "lastSuccessfulDelivery": "2026-05-01T22:10:05.000Z",
      "lastFailedDelivery": "2026-04-29T11:02:41.000Z"
    },
    "eventBreakdown": [
      {
        "eventType": "signature.document.completed",
        "total": 30,
        "successful": 29,
        "failed": 1,
        "successRate": 96.67
      }
    ]
  }
}

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" }
400days is outside 1 to 365Validation error from the query schema

  • Get Webhook for the webhook's current configuration

  • List Webhook Deliveries to inspect individual delivery attempts behind these numbers

Last updated on