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
https://g.sendcorex.com/v1/logslogs:readCó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
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
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
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"
}statusdelivered, bounced, spam o rate_limited. Filtra por uno o varios.
responseLa respuesta exacta del servidor de destino. En un bounce, dice por qué.
blockedtrue cuando Sendcorex no envió a esta dirección, por ejemplo porque está suprimida.
contentNo 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 bouncesResponde "¿llegó mi email?"
Busca a un cliente por destinatario y muestra el estado y la respuesta del servidor de sus últimos emails.
List LogsMira lo que se entregó
Get Logs con include_content devuelve el HTML, para pantallas de soporte o auditorías.
Leer el cuerpoReferencia completa
Todo lo marcado como CMD es un comando enviado a través de POST /v1/logs, hasta 20 por solicitud.