---
title: "Get webhook delivery history"
method: GET
path: "/api/webhookSubscriptions.deliveries"
---

# Get webhook delivery history

`GET /api/webhookSubscriptions.deliveries`

Returns the delivery history for a webhook subscription, including status and response information.

## Query parameters

- `workspace_id` string, required
- `subscription_id` string
- `limit` integer
- `offset` integer

## Response `200`

List of webhook deliveries

- ListWebhookDeliveriesResponse
  - `deliveries` WebhookDelivery[]
    - `id` string — Unique identifier for the delivery
    - `subscription_id` string — ID of the subscription this delivery belongs to
    - `event_type` string — Type of event that triggered the delivery
    - `payload` object — The JSON payload sent in the webhook
    - `status` 'pending' | 'delivering' | 'delivered' | 'failed' — Current status of the delivery
    - `attempts` integer — Number of delivery attempts made
    - `max_attempts` integer — Maximum number of retry attempts
    - `next_attempt_at` string, date-time, nullable — When the next retry will be attempted
    - `last_attempt_at` string, date-time, nullable — When the last attempt was made
    - `delivered_at` string, date-time, nullable — When the delivery was successfully completed
    - `last_response_status` integer, nullable — HTTP status code from the last attempt
    - `last_response_body` string, nullable — Response body from the last attempt (truncated)
    - `last_error` string, nullable — Error message from the last failed attempt
    - `created_at` string, date-time — When the delivery was created
  - `total` integer — Total number of deliveries
  - `limit` integer — Number of deliveries per page
  - `offset` integer — Offset for pagination

## Other responses

- `400` — Bad request - missing parameters
- `401` — Unauthorized - invalid or missing authentication token
- `500` — Internal server error

## Changes

- **2025-12-19** `a1331825c4e5` — 1 info
  - the `query` request parameter `subscription_id` became optional
- **2025-12-01** `bca4a43d9d46` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pierre-b/apis/notifuse-api/changes/api/webhookSubscriptions.deliveries/get.md)

---

[API](https://skmtc.dev/pierre-b/apis/notifuse-api.md) · [All operations](https://skmtc.dev/pierre-b/apis/notifuse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pierre-b/notifuse-api/revisions/d26605f2fc47/schema)