# List recent delivery attempts.

`GET /webhooks/{id}/deliveries`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-webhook-deliveries · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetWebhookDeliveries` · Tag: Webhooks

Returns recent deliveries for the subscription, most recent first, with the HTTP status the endpoint returned and the reason for any failure. Use it to confirm what was sent and to diagnose an endpoint that is failing verification or timing out.

Deliveries are retained for 7 days.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/webhooks/{id}/deliveries`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | yes | The Wheelhouse internal subscription ID. |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no | Maximum number of deliveries to return. (default: `50`, min: 1, max: 200) |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/webhooks/{id}/deliveries' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

Array of recent deliveries.

Body (`application/json`): array of object `webhook_delivery`

One attempt series to deliver one event to one subscription.

- `id` (integer, required): The Wheelhouse internal delivery ID.
- `event_id` (string (uuid), required): The idempotency key sent as the `Wh-Event-Id` header and the envelope `id`. Stable
  across retries of the same event, so it can be matched against your own records.
- `event_type` (string, required): The event type delivered.
- `status` (string, required, one of: `pending`, `delivered`, `failed`): `pending` while attempts remain, `delivered` once the endpoint returned 2xx, and
  `failed` once attempts were exhausted or the subscription was disabled.
- `attempts` (integer, required): How many times delivery has been attempted.
- `response_code` (integer, nullable): HTTP status the endpoint returned on the most recent attempt.
- `error_message` (string, nullable): Why the most recent attempt failed, when it did. An HTTP status is reported
  as-is; other failures are reported as an error type without further detail.
- `delivered_at` (string (date-time), nullable): When the endpoint accepted the delivery (ISO-8601).
- `failed_at` (string (date-time), nullable): When the delivery was given up on (ISO-8601).
- `created_at` (string (date-time)): When the delivery was queued (ISO-8601).

Example shape (generated from the schema; placeholder values, not a real response):

```json
[
  {
    "id": 0,
    "event_id": "string",
    "event_type": "string",
    "status": "pending",
    "attempts": 0,
    "response_code": 0,
    "error_message": "string",
    "delivered_at": "2026-01-01T00:00:00Z",
    "failed_at": "2026-01-01T00:00:00Z",
    "created_at": "2026-01-01T00:00:00Z"
  }
]
```

### 401

API key authorization failed.

### 404

No such webhook subscription for this user.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
