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

# Lister les livraisons

> Lister les tentatives de livraison d'un webhook

Lister les livraisons d'un webhook, de la plus récente à la plus ancienne, avec chaque tentative et le statut HTTP renvoyé par ton
endpoint.

> [!NOTE]
>
> Nécessite le scope `webhooks_manage`.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant du webhook (UUID).

### Paramètres de requête

**status** `string`

Uniquement les livraisons dans ce statut : `pending`, `succeeded`, `failed` ou `cancelled`.

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

Nombre maximal de livraisons à renvoyer, de 1 à 100.

**before** `string`

Un identifiant de livraison de ce webhook. Passe le dernier `id` d'une page pour obtenir la page suivante.

## Réponse

En cas de succès, l'API renvoie `200 OK`.

**data** `object[]` *required*

Livraisons, de la plus récente à la plus ancienne.

**livraison**

**id** `string` *required*

Identifiant de la livraison (UUID). Une livraison envoie un événement à un webhook.

**event** `object` *required*

L'événement exactement tel qu'il est envoyé dans le corps de la requête. Voir [Payload](https://docs.anivahealth.com/fr/concepts/webhooks.md#charge-utile).

**status** `string` *required*

`pending`, `succeeded`, `failed` (toutes les tentatives ont échoué ou l'endpoint a répondu `410 Gone`) ou
`cancelled` (le webhook a été désactivé pendant qu'elle était en attente).

**attempt\_count** `integer` *required*

Tentatives effectuées jusqu'ici. Un nouvel envoi repart à `0`.

**next\_attempt\_at** `string`

Instant ISO 8601 UTC de la prochaine tentative. `null` si aucune tentative n'est prévue.

**last\_attempt\_at** `string`

Instant ISO 8601 UTC de la dernière tentative. Peut être `null`.

**last\_response\_status** `integer`

Statut HTTP de la dernière tentative. `null` si aucune réponse n'est arrivée, par exemple en cas de timeout.

**last\_error** `string`

Une erreur réseau, ou le statut et le début du corps de la réponse. `null` après un succès.

**attempts** `object[]` *required*

Les 20 dernières tentatives, de la plus ancienne à la plus récente. Chacune contient `at`, `status` (statut HTTP ou `null`),
`duration_ms` et `error`.

**created\_at** `string` *required*

Instant ISO 8601 UTC de création de la livraison.

**has\_more** `boolean` *required*

`true` s'il existe des livraisons plus anciennes. Passe le dernier `id` dans `before` pour les récupérer.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Requête invalide, ou `before` n'est pas une livraison de ce webhook. Voir le message `error`. |
| `401` | Clé API invalide. |
| `403` | Aucune clé API, ou clé API sans le scope `webhooks_manage`. |
| `404` | Webhook introuvable, ou il appartient à une autre clé API. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/webhooks/4a6c8e0f-2b4d-4f6a-8c0e-2a4c6e8f0b1d/deliveries \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "7c9e1a3b-5d7f-4b2d-9e4a-6c8e0a2b4d6f",
      "event": {
        "id": "0b8e6f3a-2c4d-4e7f-9a1b-3c5d7e9f1a2b",
        "type": "appointment.confirmed",
        "timestamp": "2026-10-15T09:12:44.512Z",
        "data": {
          "object": "appointment",
          "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
          "url": "https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
          "status": "confirmed",
          "previous_status": "pending",
          "status_revision": 2
        }
      },
      "status": "succeeded",
      "attempt_count": 2,
      "next_attempt_at": null,
      "last_attempt_at": "2026-10-15T09:13:06.000Z",
      "last_response_status": 204,
      "last_error": null,
      "attempts": [
        {
          "at": "2026-10-15T09:13:01.000Z",
          "status": 503,
          "duration_ms": 412,
          "error": "HTTP 503: Service Unavailable"
        },
        {
          "at": "2026-10-15T09:13:06.000Z",
          "status": 204,
          "duration_ms": 88,
          "error": null
        }
      ],
      "created_at": "2026-10-15T09:13:00.000Z"
    }
  ],
  "has_more": false
}
```


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