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.

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

Requer o escopo logs:read na sua API key.

i

Buscar um ID custa o mesmo não importa quantos emails você envie: não há varredura por trás.

Argumentos

  • idsstring[]opcional

    Até 50 IDs de email (UUIDs). Ids repetidos contam uma vez.

    ex.: ["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]

  • idstringopcional

    Um único ID de email. Use este ou ids.

    ex.: "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"

  • include_contentbooleanopcional

    Retorna 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

  • logs

    Os logs encontrados, na ordem em que você pediu.

  • not_found

    Os ids que não existem na sua conta, têm mais de 60 dias ou pertencem a emails de warm-up.

  • logs[].id

    O ID do email (um UUID). É o id que você recebe ao enviar, e o que você passa para o Get Logs.

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

    O destinatário e o domínio do destinatário.

  • logs[].from_domain

    O domínio do remetente (a parte depois do @ em from).

  • logs[].from

    O endereço do remetente.

  • logs[].subject

    A linha de assunto.

  • logs[].status

    delivered, bounced, spam, rate_limited ou not_sent. status_code é a mesma coisa em número.

  • logs[].response

    O que o servidor de destino respondeu, por exemplo 250 2.0.0 OK ou o motivo do bounce 550.

  • logs[].message

    Detalhe extra da Sendcorex sobre a entrega, quando houver.

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

    true quando a Sendcorex não enviou para esse destinatário (suprimido ou restrito), e o motivo.

  • logs[].retries

    Quantas vezes a entrega foi tentada de novo.

  • logs[].tracking_id

    O id interno da entrega. Os webhooks de bounce e de reclamação trazem o mesmo valor.

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

    Quando o email foi enviado e quando o status dele mudou pela última vez. ISO 8601, UTC.

  • logs[].content.html

    O HTML que foi entregue. Só com include_content: true; null quando 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.

  • 401INVALID_API_KEY

    A API key não existe, foi revogada ou foi desativada no dashboard.

  • 429RATE_LIMITED

    Mais de 15 requisições/s ou 15 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.

  • CMDMISSING_SCOPE

    A API key não tem `logs:read`.

  • CMDINVALID_ARGS

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

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.