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

# Listar entregas

> Listar as tentativas de entrega de um webhook

Lista as entregas de um webhook, mais recentes primeiro, com cada tentativa e o estado HTTP com que o teu
endpoint respondeu.

> [!NOTE]
>
> Requer o âmbito `webhooks_manage`.

## Pedido

### Parâmetros de caminho

**id** `string` *required*

Identificador do webhook (UUID).

### Parâmetros de consulta

**status** `string`

Apenas entregas neste estado: `pending`, `succeeded`, `failed` ou `cancelled`.

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

Número máximo de entregas a devolver, de 1 a 100.

**before** `string`

Um ID de entrega deste webhook. Passa o último `id` de uma página para obteres a página seguinte.

## Resposta

Em caso de sucesso, a API devolve `200 OK`.

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

Entregas, mais recentes primeiro.

**entrega**

**id** `string` *required*

Identificador da entrega (UUID). Uma entrega envia um evento para um webhook.

**event** `object` *required*

O evento exatamente como foi enviado no corpo do pedido. Vê [Payload](https://docs.anivahealth.com/pt/concepts/webhooks.md#payload).

**status** `string` *required*

`pending`, `succeeded`, `failed` (todas as tentativas falharam ou o endpoint respondeu `410 Gone`) ou
`cancelled` (o webhook foi desativado enquanto estava pendente).

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

Tentativas feitas até agora. Um reenvio volta a começar em `0`.

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

Instante UTC em ISO 8601 da próxima tentativa. `null` quando não está prevista nenhuma tentativa.

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

Instante UTC em ISO 8601 da última tentativa. Pode ser `null`.

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

Estado HTTP da última tentativa. `null` quando não chegou nenhuma resposta, por exemplo num timeout.

**last\_error** `string`

Um erro de rede, ou o estado e o início do corpo da resposta. `null` após sucesso.

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

As últimas 20 tentativas, mais antigas primeiro. Cada uma tem `at`, `status` (estado HTTP ou `null`),
`duration_ms` e `error`.

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

Instante UTC em ISO 8601 em que a entrega foi criada.

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

`true` quando existem entregas mais antigas. Passa o último `id` como `before` para as obteres.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | Pedido inválido, ou `before` não é uma entrega deste webhook. Vê a mensagem de `error`. |
| `401` | Chave de API inválida. |
| `403` | Sem chave de API, ou uma chave de API sem o scope `webhooks_manage`. |
| `404` | Webhook não encontrado, ou pertence a outra chave de API. |
| `500` | Erro interno do servidor. |

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