> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List deliveries

> List the deliveries of an integration webhook endpoint over the last 30 days, newest first, with status, attempts and last error. Filter by status or event.

Returns the deliveries of the last 30 days for one endpoint, newest first. Use it
to find a failed delivery, then
[redeliver it](https://docs.qwairy.co/developers/endpoints/webhooks/redeliver.md).

Integration webhooks require an active Business, Agency Business or Enterprise plan. See [Integration webhooks](https://docs.qwairy.co/developers/integration-webhooks/overview.md).

**Authorization** `string` *required*

Bearer token for your team.

**webhookId** `string` *required*

Endpoint identifier.

**status** `string`

Filter by status: `PENDING`, `DELIVERING`, `SUCCEEDED`, `RETRYING`, `EXHAUSTED` or `CANCELLED`.

**event** `string`

Filter by [event type](https://docs.qwairy.co/developers/integration-webhooks/events.md), for example `run.completed`.

**limit** `integer` (default: 50)

Maximum number of deliveries to return, from 1 to 100.

**offset** `integer` (default: 0)

Number of deliveries to skip.

## Response

**data** `array`

The deliveries, each with the fields below.

**Delivery**

**id** `string`

Delivery identifier, stable across attempts. It is also sent in the `X-Qwairy-Delivery` header

**eventId** `string`

Identifier of the event, the `id` of the payload. Redeliveries keep it

**event** `string`

[Event type](https://docs.qwairy.co/developers/integration-webhooks/events.md)

**status** `string`

`PENDING`, `DELIVERING`, `SUCCEEDED`, `RETRYING`, `EXHAUSTED` or `CANCELLED`

**attempts** `integer`

Attempts made so far, from 0 to 8

**nextAttemptAt** `string | null`

ISO 8601 time of the next attempt

**lastAttemptAt** `string | null`

ISO 8601 time of the latest attempt

**lastStatusCode** `integer | null`

HTTP status returned by your endpoint on the latest attempt

**lastError** `string | null`

`TIMEOUT`, `CONNECTION`, `HTTP_STATUS` or `BLOCKED_TARGET` for the latest failed attempt

**deliveredAt** `string | null`

ISO 8601 time of the successful attempt

**createdAt** `string`

ISO 8601 creation time

**pagination** `object`

`total`, `count`, `limit` and `offset`.

| Status | Meaning |
| - | - |
| `PENDING` | Queued, no attempt yet |
| `DELIVERING` | An attempt is in progress |
| `SUCCEEDED` | Your endpoint answered with a 2xx status |
| `RETRYING` | The latest attempt failed and another is scheduled |
| `EXHAUSTED` | Every attempt failed |
| `CANCELLED` | The delivery was cancelled, for example when the endpoint was deleted |

## Synthetic request and response

```bash theme={null}
curl "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID/deliveries?status=EXHAUSTED&limit=20" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "data": [
    {
      "id": "ffffffff-0000-4000-8000-000000000000",
      "eventId": "evt_3f2a9c1e-5b7d-4e08-8a41-0c9d6e2b7f10",
      "event": "run.completed",
      "status": "EXHAUSTED",
      "attempts": 8,
      "nextAttemptAt": null,
      "lastAttemptAt": "2026-10-13T09:00:12.000Z",
      "lastStatusCode": 503,
      "lastError": "HTTP_STATUS",
      "deliveredAt": null,
      "createdAt": "2026-10-12T09:00:00.000Z"
    }
  ],
  "pagination": { "total": 1, "count": 1, "limit": 20, "offset": 0 }
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `401` | Flat body | Missing or invalid token |
| `403` | `INSUFFICIENT_PLAN` | Generic plan refusal: "This endpoint is not included in the team's plan." |
| `404` | `RESOURCE_NOT_FOUND` | The endpoint is missing or belongs to another team |

Read errors use the flat or nested shapes described in [Error codes](https://docs.qwairy.co/developers/errors.md). On `429`, honor `Retry-After`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.