Bounces & Complaints: Lectura
Obtener email
Todo lo que volvió para un email: su bounce o bloqueo, su queja o por qué no se envió. Una consulta, sin escaneo.
https://g.sendcorex.com/v1/feedbackcommand: get_emailRequiere el scope feedback:read en tu API key.
Un email tiene como máximo un evento de cada grupo: un bounce (bounce_hard, bounce_soft o blocked), un complaint y un dropped.
Argumentos
email_idstringobligatorioEl ID del email, el
idque recibiste al enviarlo.p. ej.
"9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/feedback',
{
commands: [
{
command: "get_email",
args: {
email_id: "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
{ 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_email",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"events": [
{
"email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"kind": "bounce_hard",
"source": "smtp",
"recipient": "old.address@gmail.com",
"from": "noreply@yourdomain.com",
"smtp_code": 550,
"enhanced_code": "5.1.1",
"diagnostic": "550-5.1.1 The email account that you tried to reach does not exist.",
"at": "2026-10-17T05:58:44.031Z"
}
]
}
}
]
}Campos de la respuesta
eventsLos eventos de este email. Vacío cuando no volvió nada (el email se entregó o tiene más de 90 días).
events[].email_idEl ID del email (un UUID): el
idque recibiste al enviarlo, y el mismo id que en Logs y en los webhooks.events[].kindQué pasó:
bounce_hard,bounce_soft,blocked,complaintodropped. Consulta Tipos más abajo.events[].sourceDe dónde lo supimos: la respuesta SMTP, un mensaje de bounce, un feedback loop, un reporte de abuso… Consulta Orígenes más abajo.
events[].recipientLa dirección a la que se envió el email.
events[].fromLa dirección del remitente.
events[].campaign_idLa campaña, cuando el email pertenece a una.
events[].smtp_code / events[].enhanced_codeEl código que respondió el servidor de destino, por ejemplo
550y5.1.1. Solo en bounces y bloqueos.events[].diagnosticLa respuesta completa del servidor de destino, o el motivo indicado en un reporte de abuso.
events[].reporting_mtaQuién lo reportó: el servidor que envió el mensaje de bounce, la dirección del feedback loop, o
webpara la página de reporte.events[].atCuándo ocurrió. ISO 8601, UTC.
Responde "¿por qué no llegó mi email?"
Lee el log y su feedback de una vez: Logs te dice el estado, este comando te dice el motivo y quién lo reportó.
Dos solicitudes, mismo id
{
"logs": {
"commands": [
{
"command": "get_logs",
"args": {
"id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
"feedback": {
"commands": [
{
"command": "get_email",
"args": {
"email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
}
}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 `feedback:read`.
- CMD
INVALID_ARGSUn argumento no es válido: tipo desconocido, `since` que no es RFC 3339, limit fuera de rango, falta `email_id`…
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.