Bounces & Complaints: Leitura
Obter email
Tudo o que voltou para um email: o bounce ou bloqueio, a reclamação ou por que ele não foi enviado. Uma consulta, sem varredura.
https://g.sendcorex.com/v1/feedbackcommand: get_emailRequer o escopo feedback:read na sua API key.
Um email tem no máximo um evento de cada grupo: um bounce (bounce_hard, bounce_soft ou blocked), um complaint e um dropped.
Argumentos
email_idstringobrigatórioO ID do email, o
idque você recebeu ao enviar.ex.:
"9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
Início 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);Resposta
{
"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 da resposta
eventsOs eventos deste email. Vazio quando nada voltou (o email foi entregue ou tem mais de 90 dias).
events[].email_idO ID do email (um UUID): o
idque você recebeu ao enviar, e o mesmo id dos Logs e dos webhooks.events[].kindO que aconteceu:
bounce_hard,bounce_soft,blocked,complaintoudropped. Veja Tipos abaixo.events[].sourceDe onde ficamos sabendo: a resposta SMTP, uma mensagem de bounce, um feedback loop, uma denúncia de abuso… Veja Origens abaixo.
events[].recipientO endereço para o qual o email foi enviado.
events[].fromO endereço do remetente.
events[].campaign_idA campanha, quando o email pertence a uma.
events[].smtp_code / events[].enhanced_codeO código que o servidor de destino respondeu, por exemplo
550e5.1.1. Só em bounces e bloqueios.events[].diagnosticA resposta completa do servidor de destino, ou o motivo informado em uma denúncia de abuso.
events[].reporting_mtaQuem reportou: o servidor que enviou a mensagem de bounce, o endereço do feedback loop, ou
webpara a página de denúncia.events[].atQuando aconteceu. ISO 8601, UTC.
Responda "por que meu email não chegou?"
Leia o log e o feedback dele de uma vez: os Logs dizem o status, este comando diz o motivo e quem reportou.
Duas requisições, mesmo 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"
}
}
]
}
}Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem `feedback:read`.
- CMD
INVALID_ARGSUm argumento é inválido: tipo desconhecido, `since` que não é RFC 3339, limit fora do intervalo, `email_id` ausente…
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.