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
https://g.sendcorex.com/v1/logslogs:readComo 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
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
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
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"
}statusdelivered, bounced, spam ou rate_limited. Filtre por um ou vários.
responseA resposta exata do servidor de destino. Em um bounce, ela diz o motivo.
blockedtrue quando a Sendcorex não enviou para esse endereço, por exemplo porque ele está suprimido.
contentNã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 bouncesResponda "meu email chegou?"
Procure um cliente pelo destinatário e mostre o status e a resposta do servidor dos últimos emails dele.
List LogsConfira um envio
Guarde o id que você recebe ao enviar e leia o log dele depois com Get Logs.
Get LogsVeja o que foi entregue
Get Logs com include_content retorna o HTML, para telas de suporte ou auditorias.
Lendo o corpoReferência completa
Tudo marcado como CMD é um comando enviado por POST /v1/logs, até 20 por requisição.