> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.
# List Webhook Deliveries
> Audit log of delivery attempts for an endpoint
## Path Parameters
Endpoint ID (`whk_*`).
## Query Parameters
Page size (1--100).
Opaque cursor.
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](/api-reference/monitoring/alerts/list)) when you need
older history.
## Response
Always `"list"`.
Array of `WebhookDelivery` rows.
Raw UUID of the attempt row.
Always `"webhook_delivery"`.
Source endpoint (`whk_*`).
Source alert (`alt_*`) when applicable.
Stable event identifier — same value as the `webhook-id` header on the delivery.
Event type (e.g., `alert.created`).
Retry attempt number (1-indexed).
UUID of this specific attempt.
One of `pending`, `delivered`, `failed`, or `exhausted`. `exhausted` is the terminal state after all 7 retry attempts have failed.
Response code from the customer endpoint.
First 1KB of the response body (truncated).
ISO timestamp embedded in the `webhook-timestamp` header.
ISO timestamp of the next scheduled retry.
When the delivery succeeded.
When the attempt was scheduled.
Whether more pages exist.
Cursor envelope.
Request identifier.
## Errors
* **400** — `since` is not a valid ISO 8601 timestamp.
* **404** — endpoint does not exist or belongs to another org.
```bash cURL theme={null}
curl "https://api.signa.so/v1/webhooks/whk_01HK.../deliveries?since=2026-05-01T00:00:00Z" \
-H "Authorization: Bearer $SIGNA_API_KEY"
```
```ts TypeScript theme={null}
const deliveries = await signa.webhooks.listDeliveries('whk_01HK...', {
since: '2026-05-01T00:00:00Z',
});
```