Logs: Lectura
Obtener logs
Lee hasta 50 logs por ID de email, el `id` que recibes al enviar. Añade `include_content` para obtener el HTML que se entregó.
https://g.sendcorex.com/v1/logscommand: get_logsRequiere el scope logs:read en tu API key.
Buscar un ID cuesta lo mismo sin importar cuántos emails envíes: no hay ningún escaneo detrás.
Argumentos
idsstring[]opcionalHasta 50 IDs de email (UUIDs). Los ids repetidos cuentan una vez.
p. ej.
["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]idstringopcionalUn único ID de email. Usa este o
ids.p. ej.
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"include_contentbooleanopcionalDevuelve también el HTML de cada email. Con él, el límite es de 10 ids por comando.
p. ej.
true
Inicio 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);Respuesta
{
"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 de la respuesta
logsLos logs encontrados, en el orden en que los pediste.
not_foundLos ids que no existen en tu cuenta, tienen más de 60 días o pertenecen a emails de warm-up.
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.
logs[].content.htmlEl HTML que se entregó. Solo con
include_content: true;nullcuando el cuerpo no se guardó.
Leer el cuerpo
El cuerpo es la parte más pesada de un log, por eso solo se devuelve cuando lo pides. Es el HTML tal como se entregó: si el tracking estaba activo, puede incluir el píxel de seguimiento y enlaces reescritos.
Cuerpo de la solicitud
{
"commands": [
{
"command": "get_logs",
"args": {
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"include_content": true
}
}
]
}Renderizar ese HTML puede cargar el píxel de seguimiento y contar como una apertura. Muéstralo en un iframe con sandbox y las imágenes remotas bloqueadas, como hace el dashboard.
Detalles de una página de List Logs
Encadena los dos comandos con $ref: los ids de la lista pasan directamente a Get Logs, en una sola solicitud.
Cuerpo de la solicitud
{
"commands": [
{
"command": "list_logs",
"id": "bounces",
"args": {
"status": "bounced",
"limit": 10
}
},
{
"command": "get_logs",
"args": {
"ids": {
"$ref": "bounces",
"path": "logs/*/id"
},
"include_content": true
}
}
]
}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
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.