---
title: Logs e exportações
description: Encontre qualquer e-mail ou requisição à API, veja o que aconteceu com ele e baixe seus dados em CSV.
ai:
  exclude: true
---

Três ferramentas ajudam a responder "o que aconteceu com isto?": a lista de e-mails, o log de requisições da API e a exportação em CSV.

## E-mails

No painel, **E-mails** lista todo e-mail que a sua equipe enviou. Busque por destinatário, assunto ou ID do e-mail, e filtre por status, chave de API, marca (domínio de envio), origem (transacional ou transmissão) e período.

Abra um e-mail para ver:

- os eventos dele em ordem: enviado, entregue, atrasado, bounce, aberto, clicado e assim por diante, com o motivo de um atraso ou de um bounce,
- o conteúdo como foi enviado (prévia, HTML ou texto simples) e os cabeçalhos,
- no caso de um e-mail que ainda não saiu, por que ele espera (limite do plano, aquecimento, uma verificação de segurança e assim por diante),
- a nota do [Deliverability Insights](/docs/pt-br/concepts/deliverability-insights).

Pela API, `GET /emails` lista os e-mails (do mais novo ao mais antigo, com paginação por cursor) e `GET /emails/{id}` devolve um e-mail com o último evento. Os dois exigem uma chave de API de acesso total. Para receber os eventos na hora em que acontecem, use [webhooks](/docs/pt-br/concepts/webhooks).

Os corpos e o histórico dos e-mails ficam guardados por 30 dias em todos os planos, e depois são removidos.

## Log de requisições da API

**Logs**, no painel, lista toda requisição feita com as suas chaves de API ou pelo MCP, dos últimos 30 dias. Cada linha mostra o status, o método, o caminho, a chave ou o aplicativo conectado que a fez e a hora.

- Busque por caminho, chave ou ID da requisição. Filtre por origem (chave de API ou MCP), por chave de API, por classe de status (`2xx`, `4xx`, `5xx`) e por período.
- Abra uma linha para ver os corpos da requisição e da resposta. Eles ajudam a descobrir por que uma chamada retornou `422` ou `403`.
- Os corpos só são guardados quando são JSON e têm menos de 64 KB. O conteúdo do e-mail (`html`, `text`) é trocado pelo tamanho, segredos como tokens e senhas aparecem como `[redacted]`, e os cabeçalhos nunca são guardados.
- Só proprietários, administradores e desenvolvedores veem os corpos.

## Exportar para CSV

As páginas que listam os seus dados têm um botão **Exportar CSV**. O arquivo leva os filtros que você aplicou, então corresponde ao que está na tela. Uma exportação tem no máximo 50.000 linhas, das mais novas para as mais antigas. Ela usa o seu login no painel, então não existe endpoint de API para isso.

O que você pode exportar depende da sua [função na equipe](/docs/pt-br/team-roles):

| Exportação | Onde | Funções |
| --- | --- | --- |
| Contatos, descadastros, destinatários de transmissões | Páginas de Contatos e a página de uma transmissão | Proprietário, administrador, marketing |
| Domínios, chaves de API, log de requisições da API | As próprias páginas | Proprietário, administrador, desenvolvedor |
| E-mails, lista de supressão, registro de auditoria | E-mails, Contatos → Supressões, Configurações | Proprietário, administrador |

A exportação do log de requisições tem as colunas `request_id`, `created_at`, `method`, `path`, `status`, `duration_ms` e `caller`. A exportação de contatos inclui uma coluna `unsubscribed` e uma coluna `unsubscribed_domains` (`*` significa a equipe inteira).

## Apagar os dados de uma pessoa

Para remover um destinatário do seu histórico, exclua o contato com `erase: true`, como descrito em [Contatos](/docs/pt-br/concepts/contacts). Isso também remove o endereço do histórico de e-mails, dos payloads de eventos e dos logs de requisições da API.
