# List deliveries for a webhook endpoint

`GET https://api.cademi.com.br/api/v3/webhooks/{webhook_id}/deliveries`

Operation ID: `webhooks.deliveries.list` · API v3

Returns the deliveries of a webhook endpoint, paginated by cursor. The collection can be filtered by status, event ID, event type, and creation time.

Required permissions: `webhooks.deliveries.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `webhook_id` | path | string | yes |  |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no |  |
| `sort` | query | string, one of `created_at`, `-created_at` | no |  |
| `status` | query | string, one of `pending`, `in_progress`, `delivered`, `failed`, `dead`, `canceled` | no |  |
| `event_id` | query | string | no |  |
| `event_type` | query | string | no |  |
| `created_after` | query | string (date-time) | no |  |
| `created_before` | query | string (date-time) | no |  |

## Responses

### 200

Returns the collection of deliveries.

Body: `data`: array of WebhookDelivery.

Fields of WebhookDelivery:

| Field | Type | Required | Description |
|---|---|---|---|
| `attempts_count` | integer | yes |  |
| `created_at` | string (date-time) | yes |  |
| `deadline_at` | string (date-time) | no |  |
| `delivered_at` | string or null (date-time) | no |  |
| `event_id` | string | yes |  |
| `id` | string | yes |  |
| `last_attempt` | WebhookDeliveryAttempt or null | no |  |
| `next_attempt_at` | string or null (date-time) | no |  |
| `object` | string, one of `webhook_delivery` | yes |  |
| `status` | string, one of `pending`, `in_progress`, `delivered`, `failed`, `dead`, `canceled` | yes |  |
| `url` | string | yes | Canonical URL of the delivery under its webhook destination. |
| `webhook_id` | string | yes |  |

### 400

The cursor is invalid or the request contains an unsupported query parameter.

Body: Error.

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The webhook endpoint was not found or is not accessible with the current credentials.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json