> ## 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.

# Lister les envois

> Listez les envois d’un endpoint de webhook d’intégration sur 30 jours, du plus récent au plus ancien, avec statut, tentatives et dernière erreur.

Renvoie les envois des 30 derniers jours pour un endpoint, du plus récent au plus ancien. Utilisez-le pour trouver un envoi échoué, puis [renvoyez-le](https://docs.qwairy.co/fr/developers/endpoints/webhooks/redeliver.md).

Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Consultez [Webhooks d’intégration](https://docs.qwairy.co/fr/developers/integration-webhooks/overview.md).

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**webhookId** `string` *required*

Identifiant de l’endpoint.

**status** `string`

Filtre par statut : `PENDING`, `DELIVERING`, `SUCCEEDED`, `RETRYING`, `EXHAUSTED` ou `CANCELLED`.

**event** `string`

Filtre par [type d’événement](https://docs.qwairy.co/fr/developers/integration-webhooks/events.md), par exemple `run.completed`.

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

Nombre maximal d’envois à renvoyer, de 1 à 100.

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

Nombre d’envois à ignorer.

## Réponse

**data** `array`

Les envois, chacun avec les champs ci-dessous.

**Delivery**

**id** `string`

Identifiant de l’envoi, stable entre les tentatives. Il est aussi envoyé dans l’en-tête `X-Qwairy-Delivery`

**eventId** `string`

Identifiant de l’événement, l’`id` de la charge utile. Les renvois le conservent

**event** `string`

[Type d’événement](https://docs.qwairy.co/fr/developers/integration-webhooks/events.md)

**status** `string`

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

**attempts** `integer`

Tentatives effectuées jusqu’ici, de 0 à 8

**nextAttemptAt** `string | null`

Date de la prochaine tentative au format ISO 8601

**lastAttemptAt** `string | null`

Date de la dernière tentative au format ISO 8601

**lastStatusCode** `integer | null`

Statut HTTP renvoyé par votre endpoint lors de la dernière tentative

**lastError** `string | null`

`TIMEOUT`, `CONNECTION`, `HTTP_STATUS` ou `BLOCKED_TARGET` pour la dernière tentative échouée

**deliveredAt** `string | null`

Date de la tentative réussie au format ISO 8601

**createdAt** `string`

Date de création au format ISO 8601

**pagination** `object`

`total`, `count`, `limit` et `offset`.

| Statut | Signification |
| - | - |
| `PENDING` | En file, aucune tentative pour l’instant |
| `DELIVERING` | Une tentative est en cours |
| `SUCCEEDED` | Votre endpoint a répondu avec un statut 2xx |
| `RETRYING` | La dernière tentative a échoué et une autre est planifiée |
| `EXHAUSTED` | Toutes les tentatives ont échoué |
| `CANCELLED` | L’envoi a été annulé, par exemple lorsque l’endpoint a été supprimé |

## Requête et réponse synthétiques

```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 }
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `401` | Corps plat | Jeton absent ou invalide |
| `403` | `INSUFFICIENT_PLAN` | Refus d’offre générique : `"This endpoint is not included in the team's plan."` |
| `404` | `RESOURCE_NOT_FOUND` | L’endpoint est absent ou appartient à une autre équipe |

Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md). Sur `429`, respectez `Retry-After`.


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