Bounces & Complaints: Rutas
Run Commands
El punto de entrada único para bounces y quejas. Envía de 1 a 20 comandos en una solicitud y obtén un resultado por comando.
https://g.sendcorex.com/v1/feedbackEl mismo sobre que Logs y Contacts: cada lectura es un comando enviado a esta ruta. Las páginas debajo de esta documentan cada comando.
Los errores se informan por comando. Un comando que falla no detiene a los demás, y el estado HTTP sigue siendo 200.
Parámetros del cuerpo
commandsobject[]obligatorioDe 1 a 20 comandos, ejecutados en orden. El cuerpo completo puede tener hasta 1 MB.
commands[].commandstringobligatoriolist_feedbackoget_email.commands[].argsobjectopcionalLos argumentos del comando. Cualquier valor puede ser un
$refal resultado de un comando anterior.commands[].idstringopcionalTu propio identificador para el resultado. Por defecto, el índice (
"0","1"…). Obligatorio si quieres usar$ref.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/feedback',
{
commands: [
{
command: "list_feedback",
id: "new",
args: {
cursor: "ZjowMDAwMDAwMDgzOjE3NjA2ODMxMjQwMzE6OWI3ZTRjMjE",
limit: 100
}
},
{
command: "get_email",
id: "one",
args: {
email_id: "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
for (const result of response.data.results) {
if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
else console.log(result.id, result.data);
}Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "list_feedback",
"id": "new",
"type": "SUCCESS",
"took_ms": 12,
"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"
},
{
"email_id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"kind": "complaint",
"source": "fbl_microsoft",
"recipient": "ana@outlook.com",
"from": "news@yourdomain.com",
"campaign_id": "c1d2e3f4-0a1b-4c2d-8e3f-4a5b6c7d8e9f",
"reporting_mta": "staff@hotmail.com",
"at": "2026-10-17T09:12:03.500Z"
}
],
"next_cursor": "ZjowMDAwMDAwMDgzOjE3NjA2ODMxMjQwMzE6OWI3ZTRjMjE",
"has_more": false
}
},
{
"command": "get_email",
"id": "one",
"type": "SUCCESS",
"took_ms": 4,
"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
typeSiempre
SUCCESScuando la solicitud en sí fue aceptada.results[].commandEl comando que produjo este resultado.
results[].idEl
idque enviaste, o el índice del comando.results[].typeSUCCESSoERROR.results[].took_msTiempo que tardó el comando dentro del servidor.
results[].dataLa salida del comando. Solo está presente cuando
typeesSUCCESS.results[].code / messageEl error. Solo está presente cuando
typeesERROR.
Autenticación
Usa la API key que creas en el dashboard, en Developers → API Keys, con el scope feedback:read.
AuthorizationEnvía
Authorization: <api key>oAuthorization: Bearer <api key>.feedback:readEl único scope que necesita esta ruta. Es de solo lectura.
Tokens de mailboxEl token del webmail no funciona aquí. Se rechaza con
WRONG_CREDENTIAL_TYPE.IPs permitidasSi la key tiene una lista de IPs permitidas, las solicitudes desde otras IPs reciben
403 IP_NOT_ALLOWED.
Qué hay en el feed
Solo lo que no llegóHard y soft bounces, bloqueos, quejas de spam y emails que nunca enviamos. Los emails entregados no están aquí: están en Logs.
Un evento por email y tipoSi el servidor rechaza un email y luego llega un mensaje de bounce para él, recibes un evento, no dos. Lo mismo para un reporte de feedback loop más un reporte de abuso.
Solo resultados finalesLos aplazamientos temporales y los reintentos nunca aparecen. Un soft bounce solo se registra cuando nos rendimos.
90 díasLos eventos se guardan durante 90 días.
Sin warm-upLos emails enviados por el warm-up de bandeja nunca aparecen.
Rate limits y caché
Los límites se aplican por IP + API key. Cuando te pasas, la solicitud se rechaza con HTTP 429 y un header Retry-After.
15 solicitudes / segundoPico de 15. Las respuestas servidas desde la caché también cuentan.
15 simultáneasComo máximo 15 solicitudes procesándose al mismo tiempo.
Caché de lectura: 1,5 sLa misma lectura dentro de 1,5 segundos devuelve el mismo resultado. Hacer polling cada pocos segundos está bien.
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.
- 400
INVALID_JSONEl cuerpo no es {"commands":[...]} o pesa más de 1 MB.
- 400
INVALID_ARGSLa solicitud no tiene comandos o tiene más de 20.
- 401
MISSING_AUTH_HEADERNo se envió ningún header Authorization.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 401
API_KEY_EXPIREDLa API key superó la fecha de expiración definida en el dashboard.
- 401
WRONG_CREDENTIAL_TYPESe envió un token de mailbox. La Feedback API necesita una API key del dashboard.
- 403
IP_NOT_ALLOWEDLa solicitud vino de una IP que no está entre las IPs permitidas de la key.
- 403
ACCOUNT_BLOCKEDLa cuenta está bloqueada.
- 403
MISSING_SCOPELa key no tiene `feedback:read`, así que no se puede ejecutar ningún comando.
- 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.
- 503
AUTH_UNAVAILABLELa autenticación no está disponible temporalmente. Inténtalo de nuevo.
- CMD
UNKNOWN_COMMANDEl nombre del comando no existe.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.