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

# Listar logs de entrega

> Histórico de entregas de um webhook, mais recentes primeiro

Permissão: `webhook.read`

Cada tentativa de entrega, inclusive reprocessamentos, gera um log.

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.upag.dev/v1/webhooks/aa0e8400-e29b-41d4-a716-446655440000/logs \
    -H "Authorization: Bearer sk_test_your_api_key"
  ```

  ```javascript Node.js SDK theme={null}
  import { Upag } from 'upag';

  const upag = new Upag('sk_test_your_api_key');

  const { data, count } = await upag.webhooks.logs.list('aa0e8400-e29b-41d4-a716-446655440000');
  ```
</CodeGroup>

<Note>
  Em produção use `https://api.upag.io/v1` com `sk_live_...`. O SDK escolhe o host pela chave.
</Note>

## Parâmetros

<ParamField path="webhookId" type="string (uuid)" required>
  ID do webhook.
</ParamField>

A listagem não é paginada: retorna todos os logs do webhook, ordenados por `createdAt` decrescente.

## Resposta

`200 OK`

```json Response theme={null}
{
  "data": [
    {
      "id": "bb0e8400-e29b-41d4-a716-446655440000",
      "webhook": "aa0e8400-e29b-41d4-a716-446655440000",
      "event": "charge.paid",
      "method": "POST",
      "url": "https://example.com/webhooks",
      "statusCode": 500,
      "duration": 120,
      "request": "{\"id\":\"880e8400-e29b-41d4-a716-446655440000\",\"event\":\"charge.paid\",\"createdAt\":\"2026-03-18T12:10:00.000Z\",\"data\":{}}",
      "response": "Internal Server Error",
      "retryCount": 0,
      "success": false,
      "createdAt": "2026-03-18T12:10:00.000Z"
    }
  ],
  "count": 1
}
```

`success` é `true` quando `statusCode` está entre 200 e 299. Detalhes dos campos: [Obter log](./get).


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