List Webhook Deliveries

Audit log of delivery attempts for an endpoint

GET /v1/webhooks/{id}/deliveries

cURL

curl "https://api.signa.so/v1/webhooks/whk_01HK.../deliveries?since=2026-05-01T00:00:00Z" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

200

{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "endpoint_id": "<string>",
      "alert_id": {},
      "event_id": "<string>",
      "event_type": "<string>",
      "attempt": 123,
      "delivery_attempt_id": "<string>",
      "status": "<string>",
      "http_status": {},
      "response_body": {},
      "signature_timestamp": "<string>",
      "next_retry_at": {},
      "delivered_at": {},
      "created_at": "<string>"
    }
  ],
  "has_more": true,
  "pagination": {},
  "request_id": "<string>"
}

Path Parameters

id · string · required

Endpoint ID (whk_*).

Query Parameters

limit · integer · default: "20"

Page size (1—100).

cursor · string

Opaque cursor.

since · string

ISO 8601 timestamp. Only deliveries with created_at >= since are returned. Useful for incremental polling — set since = last_seen_created_at and walk pages until exhausted. Composes cleanly with cursor so pagination stays stable across the filtered window.

Retention

Delivery audit rows are retained for 30 days (daily-partitioned; older partitions are dropped by the partition-maintenance cron). Queries for since values older than 30 days return an empty list rather than an error — fall back to the alert audit log (GET /v1/alerts) when you need older history.

Response

object · string

Always "list".

data · object[]

Array of WebhookDelivery rows.

Show WebhookDelivery

id · string

Raw UUID of the attempt row.

object · string

Always "webhook_delivery".

endpoint_id · string

Source endpoint (whk_*).

alert_id · string | null

Source alert (alt_*) when applicable.

event_id · string

Stable event identifier — same value as the webhook-id header on the delivery.

event_type · string

Event type (e.g., alert.created).

attempt · integer

Retry attempt number (1-indexed).

delivery_attempt_id · string

UUID of this specific attempt.

status · string

One of pending, delivered, failed, or exhausted. exhausted is the terminal state after all 7 retry attempts have failed.

http_status · integer | null

Response code from the customer endpoint.

response_body · string | null

First 1KB of the response body (truncated).

signature_timestamp · string

ISO timestamp embedded in the webhook-timestamp header.

next_retry_at · string | null

ISO timestamp of the next scheduled retry.

delivered_at · string | null

When the delivery succeeded.

created_at · string

When the attempt was scheduled.

has_more · boolean

Whether more pages exist.

pagination · object

Cursor envelope.

request_id · string

Request identifier.

Errors

• 400 — since is not a valid ISO 8601 timestamp.
• 404 — endpoint does not exist or belongs to another org.

cURL

curl "https://api.signa.so/v1/webhooks/whk_01HK.../deliveries?since=2026-05-01T00:00:00Z" \
  -H "Authorization: Bearer $SIGNA_API_KEY"