Bounces & Complaints: Reading
Get Email
Everything that came back for one email: its bounce or block, its complaint, or why it was not sent. One lookup, no scan.
https://g.sendcorex.com/v1/feedbackcommand: get_emailNeeds the feedback:read scope on your API key.
An email has at most one event of each group: one bounce (bounce_hard, bounce_soft or blocked), one complaint and one dropped.
Arguments
email_idstringrequiredThe email ID, the
idyou got back when you sent.e.g.
"9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
Quick start
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);Response
{
"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"
}
]
}
}
]
}Response fields
eventsThe events of this email. Empty when nothing came back (the email was delivered, or it is older than 90 days).
events[].email_idThe email ID (a UUID): the
idyou got back when you sent, and the same id as in Logs and webhooks.events[].kindWhat happened:
bounce_hard,bounce_soft,blocked,complaintordropped. See Kinds below.events[].sourceWhere we learned it from: the SMTP answer, a bounce message, a feedback loop, an abuse report… See Sources below.
events[].recipientThe address the email was sent to.
events[].fromThe sender address.
events[].campaign_idThe campaign, when the email belongs to one.
events[].smtp_code / events[].enhanced_codeThe code the recipient server answered, for example
550and5.1.1. Only on bounces and blocks.events[].diagnosticThe full answer of the recipient server, or the reason given in an abuse report.
events[].reporting_mtaWho reported it: the server that sent the bounce message, the feedback loop address, or
webfor the abuse page.events[].atWhen it happened. ISO 8601, UTC.
Answer "why did my email not arrive?"
Read the log and its feedback in one request: Logs tells you the status, this command tells you the reason and who reported it.
Two requests, same 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"
}
}
]
}
}Errors
HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.
- 401
INVALID_API_KEYThe API key does not exist, was revoked or was disabled in the dashboard.
- 429
RATE_LIMITEDMore than 15 requests/s or 15 in flight for the same IP + API key. Wait the number of seconds in Retry-After.
- CMD
MISSING_SCOPEThe API key does not have `feedback:read`.
- CMD
INVALID_ARGSAn argument is invalid: unknown kind, `since` that is not RFC 3339, limit out of range, missing `email_id`…
- CMD
INTERNALServer error. The detail is only written to the server log.