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

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

integer | null

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

integer | null

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

string | null

Error detail when status is timeout or error (e.g. 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 returned an HTTP response (any status code). `response_status` and `response_time_ms` are populated.
`timeout`	The request exceeded the 10-second per-attempt timeout.
`error`	A connection error, or the URL was blocked by the delivery-time SSRF re-check. `error` carries detail.
`skipped`	The subscription was not deliverable at send time (e.g. archived between dispatch and delivery).

delivered means a response was received, not that the receiver “succeeded”. If your endpoint returns a non-2xx, the attempt is still recorded as delivered with that response_status, and the delivery is 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

Products

Control Set library

Trust & security

API Reference

Data Import & Export

Integration Workflows

AI, Agents, MCP

Webhook delivery history

List delivery attempts

Path parameters

Query parameters

Example request

Example response

Response fields

Delivery status values

Error responses

​List delivery attempts

​Path parameters

​Query parameters

​Example request

​Example response

​Response fields

​Delivery status values

​Error responses

​Pagination example

List delivery attempts

Path parameters

Query parameters

Example request

Example response

Response fields

Delivery status values

Error responses

Pagination example