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ó.

POSThttps://g.sendcorex.com/v1/logscommand: get_logs
i

Requiere el scope logs:read en tu API key.

i

Buscar un ID cuesta lo mismo sin importar cuántos emails envíes: no hay ningún escaneo detrás.

Argumentos

  • idsstring[]opcional

    Hasta 50 IDs de email (UUIDs). Los ids repetidos cuentan una vez.

    p. ej. ["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]

  • idstringopcional

    Un único ID de email. Usa este o ids.

    p. ej. "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"

  • include_contentbooleanopcional

    Devuelve 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

  • logs

    Los logs encontrados, en el orden en que los pediste.

  • not_found

    Los ids que no existen en tu cuenta, tienen más de 60 días o pertenecen a emails de warm-up.

  • logs[].id

    El ID del email (un UUID). Es el id que recibes al enviar y lo que pasas a Get Logs.

  • logs[].to / logs[].domain

    El destinatario y el dominio del destinatario.

  • logs[].from_domain

    El dominio del remitente (la parte después de la @ en from).

  • logs[].from

    La dirección del remitente.

  • logs[].subject

    La línea de asunto.

  • logs[].status

    delivered, bounced, spam, rate_limited o not_sent. status_code es lo mismo como número.

  • logs[].response

    Lo que respondió el servidor de destino, por ejemplo 250 2.0.0 OK o el motivo del bounce 550.

  • logs[].message

    Detalle adicional de Sendcorex sobre la entrega, cuando lo hay.

  • logs[].blocked / logs[].block_reason

    true cuando Sendcorex no envió a este destinatario (suprimido o restringido), y por qué.

  • logs[].retries

    Cuántas veces se reintentó la entrega.

  • logs[].tracking_id

    El id interno de la entrega. Los webhooks de bounce y de queja llevan el mismo valor.

  • logs[].sent_at / logs[].updated_at

    Cuándo se envió el email y cuándo cambió su estado por última vez. ISO 8601, UTC.

  • logs[].content.html

    El HTML que se entregó. Solo con include_content: true; null cuando 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.

  • 401INVALID_API_KEY

    La API key no existe, fue revocada o se desactivó en el dashboard.

  • 429RATE_LIMITED

    Má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.

  • CMDMISSING_SCOPE

    La API key no tiene `logs:read`.

  • CMDINVALID_ARGS

    Un 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…

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.