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

# Elenca consegne

> Elenca i tentativi di consegna di un webhook

Elenca le consegne di un webhook, dalla più recente, con ogni tentativo e lo stato HTTP restituito dal tuo
endpoint.

> [!NOTE]
>
> Richiede lo scope `webhooks_manage`.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificatore del webhook (UUID).

### Parametri di query

**status** `string`

Solo le consegne in questo stato: `pending`, `succeeded`, `failed` o `cancelled`.

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

Numero massimo di consegne da restituire, da 1 a 100.

**before** `string`

Un ID di consegna di questo webhook. Passa l'ultimo `id` di una pagina per ottenere la pagina successiva.

## Risposta

In caso di successo, l'API restituisce `200 OK`.

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

Consegne, dalla più recente.

**consegna**

**id** `string` *required*

Identificatore della consegna (UUID). Una consegna invia un evento a un webhook.

**event** `object` *required*

L'evento esattamente come inviato nel corpo della richiesta. Vedi [Payload](https://docs.anivahealth.com/it/concepts/webhooks.md#payload).

**status** `string` *required*

`pending`, `succeeded`, `failed` (tutti i tentativi sono falliti o l'endpoint ha risposto `410 Gone`) o
`cancelled` (il webhook è stato disabilitato mentre era in attesa).

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

Tentativi effettuati finora. Un nuovo invio riparte da `0`.

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

Istante UTC ISO 8601 del prossimo tentativo. `null` quando non è previsto alcun tentativo.

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

Istante UTC ISO 8601 dell'ultimo tentativo. Può essere `null`.

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

Stato HTTP dell'ultimo tentativo. `null` quando non è arrivata alcuna risposta, ad esempio in caso di timeout.

**last\_error** `string`

Un errore di rete, oppure lo stato e l'inizio del corpo della risposta. `null` dopo un esito positivo.

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

Gli ultimi 20 tentativi, dal meno recente al più recente. Ciascuno contiene `at`, `status` (stato HTTP o `null`),
`duration_ms` ed `error`.

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

Istante UTC ISO 8601 in cui è stata creata la consegna.

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

`true` quando esistono consegne meno recenti. Passa l'ultimo `id` come `before` per ottenerle.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Richiesta non valida, oppure `before` non è una consegna di questo webhook. Vedi il messaggio `error`. |
| `401` | Chiave API non valida. |
| `403` | Nessuna chiave API, oppure una chiave API senza lo scope `webhooks_manage`. |
| `404` | Webhook non trovato, oppure appartiene a un'altra chiave API. |
| `500` | Errore interno del server. |

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