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

# Logs da API

> Consulte o histórico de chamadas HTTP para auditar integrações e debugar erros.

<Tip>
  Logs da API são o **extrato da integração**: cada chamada HTTP com request, response e status — ideal para debugar 401, 403 e 400.
</Tip>

## O que são?

Histórico de **todas as chamadas** à API no workspace: método, endpoint, body (mascarado), resposta e duração.

Pense no extrato do cartão: não mostra se a mensagem chegou ao cliente, mas mostra **cada transação** entre seu sistema e a Notifique.

## Logs vs webhooks

| Situação                      | Logs    | Webhooks |
| ----------------------------- | ------- | -------- |
| Por que a API retornou 403?   | **Sim** | Não      |
| Qual chave fez a chamada?     | **Sim** | Não      |
| Mensagem entregue ao cliente? | Não     | **Sim**  |
| Reagir em tempo real          | Não     | **Sim**  |

## Consultar via API

Escopo: `logs:read`.

```bash theme={null}
curl "https://api.notifique.dev/v1/logs?limit=20&status=403" \
  -H "Authorization: Bearer sk_live_..."
```

Filtros: `status` (ex.: `200,403`), `method`, `startDate`, `endDate`, `apiKeyId`, `page`, `limit` (máx. 100).

## Detalhe por ID

`GET /v1/logs/:id` — corpo completo, `correlationId`, nome e prefixo da API key.

```bash theme={null}
curl https://api.notifique.dev/v1/logs/cllog123... \
  -H "Authorization: Bearer sk_live_..."
```

Exemplo de item (lista):

```json theme={null}
{
  "id": "cllog123...",
  "endpoint": "/v1/whatsapp/messages",
  "method": "POST",
  "status": 403,
  "requestBody": { "to": "[REDACTED]" },
  "responseBody": { "success": false, "code": "FORBIDDEN" },
  "duration": 42,
  "apiKeyId": "clkey456...",
  "createdAt": "2026-08-14T14:30:00.000Z"
}
```

## Códigos de erro

Cruze o `code` do `responseBody` com [Respostas de erro](/guides/conceitos/resposta-de-erros).

## Próximos passos

* [Webhooks](/platform-api/como-funciona/webhooks): eventos de entrega e mensagens
* [Escopos](/platform-api/como-funciona/escopos-api-key): incluir `logs:read` na chave