Webhook delivery history

Coverbase records every webhook delivery attempt as an audit row. Whether the delivery came from a domain-event fan-out, a workflow send_webhook action, or a manual test, there is one history record per attempt, including deliveries that were blocked by the URL restrictions. Use the history to debug failing receivers, confirm a delivery happened, and monitor delivery health over time. The aggregate health of a subscription (last_delivery_status, delivery_success_rate, delivery_count) is also surfaced on the webhook object.

In the dashboard

Under Configuration → Webhooks, click a webhook’s Delivery history button, or its Health value. The dialog lists each attempt with its Event, Status, Response (HTTP status and round-trip time) and Attempted time, newest first, with View payload to expand what was sent. The Status filter narrows the page you are looking at, and Previous and Next page through the rest.

List delivery attempts

GET

GET /v1/webhooks/{webhook_id}/deliveries

Returns the delivery attempts for one webhook, newest first, paginated. Org-scoped to the API key.

Path parameters

string

required

The webhook subscription ID (cbwh_...).

Query parameters

integer

default:"50"

Page size. Clamped to the range 1-100 (values outside the range are clamped, not rejected).

integer

default:"0"

Number of records to skip. Negative values are clamped to 0.

Example request

cURL

curl "https://api.coverbase.app/v1/webhooks/cbwh_d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9/deliveries?limit=50&offset=0" \
  -H "Authorization: Bearer ak_live_xxx"

Python

import os
import requests

API_KEY = os.environ["COVERBASE_API_KEY"]
BASE_URL = "https://api.coverbase.app"
webhook_id = "cbwh_d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9"

resp = requests.get(
    f"{BASE_URL}/v1/webhooks/{webhook_id}/deliveries",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"limit": 50, "offset": 0},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

Example response

{
  "data": [
    {
      "id": "cbwhd_9c7b4a2e8b3c1a4d9e7f2c5b6a8d1e3f",
      "webhook_id": "cbwh_d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
      "event_id": "cbevt_8b3c1a4d9e7f2c5b6a8d1e3f9c7b4a2e",
      "event_type": "Vendor.Created",
      "status": "delivered",
      "response_status": 200,
      "response_time_ms": 142,
      "error": null,
      "payload": { "event_type": "Vendor.Created", "vendor_id": "cbvndr_e448ba62882143f3ba0c140bb2e30162" },
      "attempted_at": 1747400001,
      "created_at": 1747400001
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

Response fields

object[]

The page of delivery attempts, newest first. Each item:

Show delivery fields

string

Delivery attempt ID (cbwhd_...).

string

The subscription this attempt belongs to (cbwh_...).

string

The shared event ID (cbevt_...) sent in the envelope and the X-Coverbase-Event-Id header.

string

The event type the delivery was labeled with.

string

One of delivered, timeout, error.

integer | null

The receiver’s HTTP status code, or null if no response was received (timeout, connection error or blocked URL).

integer | null

Round-trip time in milliseconds, or null if no response was received.

string | null

Error detail when status is timeout or error (for example, a blocked-URL message); otherwise null.

object

The data object that was delivered for this attempt.

integer

Unix timestamp (seconds) when the attempt was made.

integer

Unix timestamp (seconds) when the audit row was written.

integer

Total recorded attempts for this webhook, ignoring limit/offset. Page until offset + len(data) >= total.

integer

The effective page size after clamping.

integer

The effective offset after clamping.

Delivery status values

Status	Meaning
`delivered`	The receiver answered with a `2xx` status. `response_status` and `response_time_ms` are populated.
`timeout`	The request exceeded the 10-second per-attempt timeout.
`error`	The receiver answered with a non-`2xx` status (`response_status` is populated), a connection error occurred, or the URL was blocked by the delivery-time SSRF re-check. `error` carries detail.

Every attempt is its own row. A delivery that timed out, lost its connection, or got a 408, 429 or 5xx answer is retried with the same event_id, up to six attempts in all, so the newest row for an event_id is where that delivery stands. Other non-2xx answers are recorded as error and not retried.

Error responses

Status	Body	When
404	`{"detail": {"code": "webhook_not_found", "message": "Webhook not found."}}`	The `webhook_id` does not exist or is not in the API key’s org.

Pagination example

curl "https://api.coverbase.app/v1/webhooks/cbwh_d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9/deliveries?limit=50&offset=50" \
  -H "Authorization: Bearer ak_live_xxx"

See API conventions → Timestamps for the epoch-seconds convention used by attempted_at and created_at.

Getting started

API reference

Data import and export

Field reference

Integration workflows

AI, agents and MCP

In the dashboard

List delivery attempts

Path parameters

Query parameters

Example request

Example response

Response fields

Delivery status values

Error responses

​In the dashboard

​List delivery attempts

​Path parameters

​Query parameters

​Example request

​Example response

​Response fields

​Delivery status values

​Error responses

​Pagination example

In the dashboard

List delivery attempts

Path parameters

Query parameters

Example request

Example response

Response fields

Delivery status values

Error responses

Pagination example