Logs: Lectura
Listar logs
Tus logs de entrega, del más reciente al más antiguo, hasta 50 por página. Filtra por estado, destinatario, asunto, dominio, remitente y fecha, en cualquier combinación.
https://g.sendcorex.com/v1/logscommand: list_logsRequiere el scope logs:read en tu API key.
Los filtros se combinan con AND. Sin after, obtienes los últimos 60 días, que es el tiempo que se guardan los logs.
Los emails de warm-up nunca aparecen aquí, y el cuerpo del email nunca forma parte de una lista. Usa Get Logs con include_content para leer uno.
Argumentos
statusstring | string[]opcionaldelivered,bounced,spam,rate_limitedonot_sent, o una lista de ellos. Sin él, obtienes los cinco.p. ej.
"bounced"recipientstringopcionalUna dirección de email completa. Se ignoran las mayúsculas y los espacios alrededor.
p. ej.
"ana@acme.com"subjectstringopcionalPalabras del asunto. Palabras completas, y todas deben estar:
order shippedencuentra "Your order #1042 has shipped",ordno. Se ignoran los acentos y las mayúsculas.p. ej.
"order shipped"searchstringopcionalTexto libre, para un cuadro de búsqueda. Con una
@es un destinatario; si no, son palabras del asunto.p. ej.
"ana@acme.com"domainstringopcionalEl dominio del destinatario, exacto.
p. ej.
"gmail.com"fromstringopcionalLa dirección del remitente, exacta.
p. ej.
"noreply@yourdomain.com"afterstring | numberopcionalSolo logs enviados en este momento o después. ISO 8601,
YYYY-MM-DD(medianoche UTC) o epoch en milisegundos. Por defecto, hace 60 días.p. ej.
"2026-10-01"beforestring | numberopcionalSolo logs enviados antes de este momento. Mismos formatos.
p. ej.
"2026-10-17T00:00:00Z"limitnumberopcionalTamaño de página, de 1 a 50. Por defecto, 50.
p. ej.
50cursorstringopcionalEl
next_cursorde la página anterior. Envíalo con los mismos filtros.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/logs',
{
commands: [
{
command: "list_logs",
args: {
status: "bounced",
after: "2026-10-01",
limit: 50
}
}
]
},
{ 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);Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "list_logs",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"logs": [
{
"id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"to": "old.address@gmail.com",
"from": "noreply@yourdomain.com",
"domain": "gmail.com",
"from_domain": "yourdomain.com",
"subject": "Your order #1042 has shipped",
"status": "bounced",
"status_code": 6,
"response": "550 5.1.1 The email account that you tried to reach does not exist.",
"message": null,
"blocked": false,
"block_reason": null,
"retries": 0,
"tracking_id": "7CK-JDL-Z2M-20261017",
"sent_at": "2026-10-17T05:58:44.031Z",
"updated_at": "2026-10-17T05:58:45.600Z"
}
],
"count": 1,
"has_more": true,
"next_cursor": "MDAwMDAwMDA4MzowOjgyMzkzMTU5OTg3OTU6M2YyYTFi",
"partial": false,
"total": 1240,
"total_exact": true
}
}
]
}Campos de la respuesta
logsLos logs de esta página, del más reciente al más antiguo. Cada uno tiene los campos de abajo.
countCuántos logs hay en esta página.
has_more / next_cursorMientras
has_moreseatrue, envíanext_cursorcomocursorcon los mismos filtros.partialtruecuando la búsqueda alcanzó su límite de tiempo antes de llenar la página. La página puede tener menos logs, incluso cero, ynext_cursorcontinúa desde donde se detuvo.total / total_exactCuántos logs coinciden con los filtros, solo en la primera página (la solicitud sin
cursor). En las páginas siguientes ambos sonnull, así que guarda el primer valor.totalsolo trae un número cuando es exacto (total_exact: true). Contotal: nullytotal_exact: falsehay demasiados para contar; con ambosnullla búsqueda no se puede contar (por ejemplo, un asunto sin palabras indexables). En ambos casos, sigue paginando conhas_more.logs[].idEl ID del email (un UUID). Es el
idque recibes al enviar y lo que pasas a Get Logs.logs[].to / logs[].domainEl destinatario y el dominio del destinatario.
logs[].from_domainEl dominio del remitente (la parte después de la @ en
from).logs[].fromLa dirección del remitente.
logs[].subjectLa línea de asunto.
logs[].statusdelivered,bounced,spam,rate_limitedonot_sent.status_codees lo mismo como número.logs[].responseLo que respondió el servidor de destino, por ejemplo
250 2.0.0 OKo el motivo del bounce550.logs[].messageDetalle adicional de Sendcorex sobre la entrega, cuando lo hay.
logs[].blocked / logs[].block_reasontruecuando Sendcorex no envió a este destinatario (suprimido o restringido), y por qué.logs[].retriesCuántas veces se reintentó la entrega.
logs[].tracking_idEl id interno de la entrega. Los webhooks de bounce y de queja llevan el mismo valor.
logs[].sent_at / logs[].updated_atCuándo se envió el email y cuándo cambió su estado por última vez. ISO 8601, UTC.
Estados
deliveredEl servidor de destino aceptó el email.
bouncedEl servidor de destino lo rechazó definitivamente: la dirección no existe, el dominio no acepta correo…
spamEl servidor de destino lo rechazó como spam.
rate_limitedEl servidor de destino lo siguió aplazando y se agotaron los reintentos.
not_sentNo enviado por un motivo de tu cuenta (por ejemplo, sin créditos, cuenta bloqueada o restringida, dominio del remitente en Spamhaus o sin DKIM, o From inválido). No es un rebote. El motivo exacto está en
response.
Los emails que aún esperan un reintento todavía no están aquí: aparecen cuando llegan a uno de estos cinco estados.
Paginación
Sigue mientras has_more sea true. No te detengas en una página corta o vacía: cuando partial es true, a la búsqueda se le acabó el tiempo en esa llamada, no los logs.
Node.js
const logs = [];
let cursor;
do {
const [result] = await call({
command: 'list_logs',
args: { status: 'bounced', after: '2026-10-01', ...(cursor ? { cursor } : {}) },
});
logs.push(...result.data.logs);
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);call es cualquier helper que envía { commands: [...] } por POST a /v1/logs y devuelve results, como en Run Commands.
Un cursor solo funciona con los filtros de los que vino. Cambia un filtro y obtendrás INVALID_CURSOR: empieza de nuevo sin cursor.
Seguir los nuevos bounces
Para reaccionar a los bounces (o a cualquier otra cosa) en cuanto ocurren, haz polling con after igual al sent_at más reciente que hayas visto. after incluye ese momento, así que el último log vuelve una vez más: omite los ids que ya tienes.
Node.js
const seen = new Set();
let since = new Date(Date.now() - 3600_000).toISOString(); // start with the last hour
setInterval(async () => {
let cursor;
do {
const [result] = await call({
command: 'list_logs',
args: { status: 'bounced', after: since, ...(cursor ? { cursor } : {}) },
});
for (const log of result.data.logs) {
if (seen.has(log.id)) continue;
seen.add(log.id);
if (log.sent_at > since) since = log.sent_at;
await removeFromMyList(log.to, log.response); // your code
}
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);
}, 10_000);Las lecturas idénticas dentro de 1,5 segundos comparten un resultado, así que varios workers consultando lo mismo no añaden carga. Si necesitas el evento en el momento en que ocurre, usa el webhook bounced.
Más ejemplos
Cuerpo de la solicitud
{
"commands": [
{
"command": "list_logs",
"id": "ana",
"args": {
"recipient": "ana@acme.com"
}
},
{
"command": "list_logs",
"id": "shipped",
"args": {
"subject": "order shipped",
"status": "delivered",
"after": "2026-10-10"
}
},
{
"command": "list_logs",
"id": "gmail_spam",
"args": {
"domain": "gmail.com",
"status": [
"spam",
"bounced"
]
}
},
{
"command": "list_logs",
"id": "one_day",
"args": {
"after": "2026-10-16",
"before": "2026-10-17",
"limit": 20
}
}
]
}El log
List Logs y Get Logs devuelven la misma estructura.
Log
{
"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"
}Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene `logs:read`.
- CMD
INVALID_ARGSUn argumento no es válido: estado desconocido, destinatario que no es un email completo, limit fuera de rango, id que no es un UUID, after posterior a before…
- CMD
INVALID_CURSOREl cursor está mal formado, o viene de otra búsqueda u otra cuenta. Empieza de nuevo sin cursor.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.