Logs

Sabe qué pasó con cada email

Busca tus entregas por estado, destinatario, asunto y fecha, lee cualquier email por su id y sigue los bounces a medida que llegan, todo con un solo endpoint.

  • Comandos JSON
  • 50 por página
  • Filtros y búsqueda
  • Últimos 60 días
  • Solo lectura
POSThttps://g.sendcorex.com/v1/logslogs:read

Cómo funciona

Un log por email

Cada email que envías tiene un log con su destinatario, asunto, estado y la respuesta del servidor de destino. El id es el mismo que recibiste al enviarlo.

Un endpoint, dos comandos

list_logs busca y pagina tus logs; get_logs los lee por id. Ambos van a POST /v1/logs, hasta 20 comandos por solicitud.

Hecho para polling

Pide nuevos bounces cada pocos segundos sin preocuparte por la carga: las lecturas repetidas comparten un resultado y los emails de warm-up nunca estorban.

Primeros pasos

Solo necesitas la key antes de tu primera solicitud.

  1. 1

    Crea una API key con logs:read

    En el dashboard, abre Developers → API Keys y crea una key con el scope logs:read. Puedes añadirlo a una key que ya usas para enviar.

    El token del webmail no funciona aquí. Los logs usan la API key del dashboard.

  2. 2

    Busca en tus logs

    List Logs acepta cualquier combinación de estado, destinatario, palabras del asunto, dominio, remitente y fechas, y devuelve 50 logs por página.

  3. 3

    Lee un email

    Get Logs lee hasta 50 logs por id. Añade include_content para ver el HTML que se entregó.

El log

Ambos comandos devuelven logs con esta estructura.

{
  "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"
}
status

delivered, bounced, spam o rate_limited. Filtra por uno o varios.

response

La respuesta exacta del servidor de destino. En un bounce, dice por qué.

blocked

true cuando Sendcorex no envió a esta dirección, por ejemplo porque está suprimida.

content

No forma parte del log por defecto. Get Logs devuelve el HTML con include_content.

Tu primera solicitud

Dos búsquedas en una solicitud: tus bounces de este mes y los últimos emails a un cliente. Reemplaza SENDCOREX_API_KEY por tu API key.

curl -X POST 'https://g.sendcorex.com/v1/logs' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_logs", "args": { "status": "bounced", "after": "2026-10-01" } },
    { "command": "list_logs", "args": { "recipient": "ana@acme.com", "limit": 10 } }
  ]
}'

Obtienes un resultado por comando, cada uno con sus logs y un next_cursor para la página siguiente. La misma solicitud en 8 lenguajes está en List Logs.

Tareas comunes

Limpia los bounces de tu lista

Consulta los logs bounced cada pocos segundos con after en el último que viste y elimina esas direcciones de tu lado.

Seguir los nuevos bounces

Responde "¿llegó mi email?"

Busca a un cliente por destinatario y muestra el estado y la respuesta del servidor de sus últimos emails.

List Logs

Revisa un envío

Guarda el id que recibes al enviar y lee su log más tarde con Get Logs.

Get Logs

Mira lo que se entregó

Get Logs con include_content devuelve el HTML, para pantallas de soporte o auditorías.

Leer el cuerpo

Referencia completa

Todo lo marcado como CMD es un comando enviado a través de POST /v1/logs, hasta 20 por solicitud.