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

# List Deliveries

> List the delivery attempts of a webhook

List the deliveries of one webhook, newest first, with every attempt and the HTTP status your
endpoint answered.

> [!NOTE]
>
> Requires the `webhooks_manage` scope.

## Request

### Path parameters

**id** `string` *required*

Webhook identifier (UUID).

### Query parameters

**status** `string`

Only deliveries in this status: `pending`, `succeeded`, `failed` or `cancelled`.

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

Maximum number of deliveries to return, 1 to 100.

**before** `string`

A delivery id of this webhook. Pass the last `id` of a page to get the next page.

## Response

On success, the API returns `200 OK`.

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

Deliveries, newest first.

**delivery**

**id** `string` *required*

Delivery identifier (UUID). One delivery sends one event to one webhook.

**event** `object` *required*

The event exactly as sent in the request body. See [Payload](/concepts/webhooks#payload).

**status** `string` *required*

`pending`, `succeeded`, `failed` (all attempts failed or the endpoint answered `410 Gone`) or
`cancelled` (the webhook was disabled while it was pending).

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

Attempts made so far. A resend starts again at `0`.

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

ISO 8601 UTC instant of the next attempt. `null` when no attempt is planned.

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

ISO 8601 UTC instant of the last attempt. May be `null`.

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

HTTP status of the last attempt. `null` when no response arrived, for example on a timeout.

**last\_error** `string`

A network error, or the status and the start of the response body. `null` after a success.

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

The last 20 attempts, oldest first. Each has `at`, `status` (HTTP status or `null`),
`duration_ms` and `error`.

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

ISO 8601 UTC instant the delivery was created.

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

`true` when older deliveries exist. Pass the last `id` as `before` to get them.

## Error responses

| Status | Description |
| - | - |
| `400` | Invalid request, or `before` is not a delivery of this webhook. See the `error` message. |
| `401` | Invalid API key. |
| `403` | No API key, or an API key without the `webhooks_manage` scope. |
| `404` | Webhook not found, or it belongs to another API key. |
| `500` | Internal server error. |

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