Logs

Saiba o que aconteceu com cada email

Busque suas entregas por status, destinatário, assunto e data, leia qualquer email pelo id e acompanhe os bounces conforme chegam, tudo por um único endpoint.

  • Comandos JSON
  • 50 por página
  • Filtros e busca
  • Últimos 60 dias
  • Somente leitura
POSThttps://g.sendcorex.com/v1/logslogs:read

Como funciona

Um log por email

Cada email que você envia ganha um log com o destinatário, o assunto, o status e a resposta do servidor de destino. O id é o mesmo que você recebeu ao enviar.

Um endpoint, dois comandos

list_logs busca e pagina seus logs; get_logs lê logs pelo id. Os dois vão para POST /v1/logs, até 20 comandos por requisição.

Feito para polling

Peça novos bounces a cada poucos segundos sem se preocupar com carga: leituras repetidas compartilham um resultado, e emails de warm-up nunca atrapalham.

Primeiros passos

Só a key é necessária antes da sua primeira requisição.

  1. 1

    Crie uma API key com logs:read

    No dashboard, abra Developers → API Keys e crie uma key com o escopo logs:read. Você pode adicioná-lo a uma key que já usa para enviar.

    O token do webmail não funciona aqui. Os logs usam a API key do dashboard.

  2. 2

    Busque seus logs

    List Logs aceita qualquer combinação de status, destinatário, palavras do assunto, domínio, remetente e datas, e retorna 50 logs por página.

  3. 3

    Leia um email

    Get Logs lê até 50 logs pelo id. Adicione include_content para ver o HTML que foi entregue.

O log

Os dois comandos retornam logs neste formato.

{
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "to": "ana@acme.com",
  "from": "noreply@yourdomain.com",
  "domain": "acme.com",
  "from_domain": "yourdomain.com",
  "subject": "Your order #1042 has shipped",
  "status": "delivered",
  "status_code": 2,
  "response": "250 2.0.0 OK 1760684401 a1si123456",
  "message": null,
  "blocked": false,
  "block_reason": null,
  "retries": 0,
  "tracking_id": "7CK-JDL-Y1L-20261017",
  "sent_at": "2026-10-17T06:00:01.204Z",
  "updated_at": "2026-10-17T06:00:02.913Z"
}
status

delivered, bounced, spam ou rate_limited. Filtre por um ou vários.

response

A resposta exata do servidor de destino. Em um bounce, ela diz o motivo.

blocked

true quando a Sendcorex não enviou para esse endereço, por exemplo porque ele está suprimido.

content

Não faz parte do log por padrão. Get Logs retorna o HTML com include_content.

Sua primeira requisição

Duas buscas em uma requisição: seus bounces deste mês e os últimos emails para um cliente. Substitua SENDCOREX_API_KEY pela sua API key.

curl -X POST 'https://g.sendcorex.com/v1/logs' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_logs", "args": { "status": "bounced", "after": "2026-10-01" } },
    { "command": "list_logs", "args": { "recipient": "ana@acme.com", "limit": 10 } }
  ]
}'

Você recebe um resultado por comando, cada um com seus logs e um next_cursor para a próxima página. A mesma requisição em 8 linguagens está em List Logs.

Tarefas comuns

Limpe bounces da sua lista

Consulte os logs bounced a cada poucos segundos com after no último que você viu e remova esses endereços do seu lado.

Acompanhando novos bounces

Responda "meu email chegou?"

Procure um cliente pelo destinatário e mostre o status e a resposta do servidor dos últimos emails dele.

List Logs

Confira um envio

Guarde o id que você recebe ao enviar e leia o log dele depois com Get Logs.

Get Logs

Veja o que foi entregue

Get Logs com include_content retorna o HTML, para telas de suporte ou auditorias.

Lendo o corpo

Referência completa

Tudo marcado como CMD é um comando enviado por POST /v1/logs, até 20 por requisição.