Logs: Leitura
Obter logs
Leia até 50 logs pelo ID do email, o `id` que você recebe ao enviar. Adicione `include_content` para receber o HTML que foi entregue.
https://g.sendcorex.com/v1/logscommand: get_logsRequer o escopo logs:read na sua API key.
Buscar um ID custa o mesmo não importa quantos emails você envie: não há varredura por trás.
Argumentos
idsstring[]opcionalAté 50 IDs de email (UUIDs). Ids repetidos contam uma vez.
ex.:
["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]idstringopcionalUm único ID de email. Use este ou
ids.ex.:
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"include_contentbooleanopcionalRetorna também o HTML de cada email. Com ele, o limite é de 10 ids por comando.
ex.:
true
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/logs',
{
commands: [
{
command: "get_logs",
args: {
ids: [
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"00000000-0000-4000-8000-000000000000"
]
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Resposta
{
"type": "SUCCESS",
"results": [
{
"command": "get_logs",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"logs": [
{
"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"
}
],
"not_found": [
"00000000-0000-4000-8000-000000000000"
]
}
}
]
}Campos da resposta
logsOs logs encontrados, na ordem em que você pediu.
not_foundOs ids que não existem na sua conta, têm mais de 60 dias ou pertencem a emails de warm-up.
logs[].idO ID do email (um UUID). É o
idque você recebe ao enviar, e o que você passa para o Get Logs.logs[].to / logs[].domainO destinatário e o domínio do destinatário.
logs[].from_domainO domínio do remetente (a parte depois do @ em
from).logs[].fromO endereço do remetente.
logs[].subjectA linha de assunto.
logs[].statusdelivered,bounced,spam,rate_limitedounot_sent.status_codeé a mesma coisa em número.logs[].responseO que o servidor de destino respondeu, por exemplo
250 2.0.0 OKou o motivo do bounce550.logs[].messageDetalhe extra da Sendcorex sobre a entrega, quando houver.
logs[].blocked / logs[].block_reasontruequando a Sendcorex não enviou para esse destinatário (suprimido ou restrito), e o motivo.logs[].retriesQuantas vezes a entrega foi tentada de novo.
logs[].tracking_idO id interno da entrega. Os webhooks de bounce e de reclamação trazem o mesmo valor.
logs[].sent_at / logs[].updated_atQuando o email foi enviado e quando o status dele mudou pela última vez. ISO 8601, UTC.
logs[].content.htmlO HTML que foi entregue. Só com
include_content: true;nullquando o corpo não foi armazenado.
Lendo o corpo
O corpo é a parte mais pesada de um log, por isso só volta quando você pede. É o HTML como foi entregue: se o tracking estava ligado, pode incluir o pixel de rastreamento e links reescritos.
Corpo da requisição
{
"commands": [
{
"command": "get_logs",
"args": {
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"include_content": true
}
}
]
}Renderizar esse HTML pode carregar o pixel de rastreamento e contar como uma abertura. Mostre-o em um iframe com sandbox e imagens remotas bloqueadas, como o dashboard faz.
Detalhes de uma página do List Logs
Encadeie os dois comandos com $ref: os ids da lista vão direto para o Get Logs, em uma única requisição.
Corpo da requisição
{
"commands": [
{
"command": "list_logs",
"id": "bounces",
"args": {
"status": "bounced",
"limit": 10
}
},
{
"command": "get_logs",
"args": {
"ids": {
"$ref": "bounces",
"path": "logs/*/id"
},
"include_content": true
}
}
]
}Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem `logs:read`.
- CMD
INVALID_ARGSUm argumento é inválido: status desconhecido, destinatário que não é um email completo, limit fora do intervalo, id que não é UUID, after depois de before…
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.