Bounces & Complaints: Lesen
Feedback auflisten
Jeder Bounce, jede Blockierung und jede Beschwerde Ihres Kontos, älteste zuerst, damit Sie mit einem Cursor pollen können und keine verpassen.
https://g.sendcorex.com/v1/feedbackcommand: list_feedbackErfordert den Scope feedback:read für Ihren API key.
Behalten Sie next_cursor und senden Sie ihn beim nächsten Aufruf. Er kommt immer zurück, auch wenn es nichts Neues gab, sodass Ihre Schleife eine leere Seite nie als Sonderfall behandeln muss.
Ereignisse erscheinen etwa 10 Sekunden, nachdem sie passiert sind. Diese kleine Verzögerung garantiert, dass zwischen zwei Abfragen nichts übersprungen wird.
Argumente
cursorstringoptionalDer
next_cursordes vorherigen Aufrufs. Beim ersten Mal ohne ihn (oder mitsince) beginnen.z. B.
"ZjowMDAwMDAwMDgzOjE3NjA2ODMxMjQwMzE6OWI3ZTRjMjE"sincestringoptionalRFC 3339. Wo Sie beginnen, wenn Sie noch keinen Cursor haben. Wird ignoriert, wenn
cursorgesendet wird. Ohne beides beginnen Sie am Anfang der 90 Tage.z. B.
"2026-10-01T00:00:00Z"kindsstring[]optionalNur diese Typen:
bounce_hard,bounce_soft,blocked,complaint,dropped. Ein kommagetrennter String funktioniert auch. Ohne Angabe erhalten Sie alle.z. B.
["bounce_hard", "complaint"]limitnumberoptionalEreignisse pro Aufruf, von 1 bis 1000. Standard: 100.
z. B.
100
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/feedback',
{
commands: [
{
command: "list_feedback",
args: {
cursor: "ZjowMDAwMDAwMDgzOjE3NjA2ODMxMjQwMzE6OWI3ZTRjMjE",
kinds: [
"bounce_hard",
"complaint"
],
limit: 100
}
}
]
},
{ 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);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "list_feedback",
"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"
},
{
"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"
},
{
"email_id": "5a6b7c8d-1e2f-4a3b-9c4d-5e6f7a8b9c0d",
"kind": "blocked",
"source": "smtp",
"recipient": "paulo@corp-example.com",
"from": "noreply@yourdomain.com",
"smtp_code": 554,
"enhanced_code": "5.7.1",
"diagnostic": "554 5.7.1 Service unavailable; client host blocked using zen.spamhaus.org",
"at": "2026-10-17T10:40:19.002Z"
}
],
"next_cursor": "ZjowMDAwMDAwMDgzOjE3NjA2ODMxMjQwMzE6OWI3ZTRjMjE",
"has_more": false
}
}
]
}Antwortfelder
eventsDie Ereignisse dieses Aufrufs, älteste zuerst. Jedes hat die unten stehenden Felder.
next_cursorSenden Sie ihn beim nächsten Aufruf als
cursor. Wenn nichts Neues kam, ist es derselbe Cursor, den Sie gesendet haben.has_moretrue, wenn bereits weitere Ereignisse warten: Rufen Sie sofort erneut auf, statt auf Ihre nächste Abfrage zu warten.events[].email_idDie E-Mail-ID (eine UUID): die
id, die Sie beim Senden erhalten haben, und dieselbe ID wie in Logs und Webhooks.events[].kindWas passiert ist:
bounce_hard,bounce_soft,blocked,complaintoderdropped. Siehe Typen unten.events[].sourceWoher wir es wissen: die SMTP-Antwort, eine Bounce-Nachricht, ein Feedback Loop, eine Missbrauchsmeldung… Siehe Quellen unten.
events[].recipientDie Adresse, an die die E-Mail gesendet wurde.
events[].fromDie Absenderadresse.
events[].campaign_idDie Kampagne, falls die E-Mail zu einer gehört.
events[].smtp_code / events[].enhanced_codeDer Code, den der Empfängerserver geantwortet hat, zum Beispiel
550und5.1.1. Nur bei Bounces und Blockierungen.events[].diagnosticDie vollständige Antwort des Empfängerservers oder der in einer Missbrauchsmeldung genannte Grund.
events[].reporting_mtaWer es gemeldet hat: der Server, der die Bounce-Nachricht gesendet hat, die Feedback-Loop-Adresse oder
webfür die Meldeseite.events[].atWann es passiert ist. ISO 8601, UTC.
Typen
bounce_hardDie Adresse existiert nicht oder nimmt keine E-Mails mehr an (5.1.x, die meisten 5xx). Entfernen Sie sie aus Ihren Listen: Erneutes Senden schadet Ihrer Reputation.
bounce_softEin vorübergehendes Problem, das sich nicht rechtzeitig gelöst hat: Postfach voll (5.2.2), ein 4xx ohne verbleibende Versuche oder die E-Mail ist in der Warteschlange abgelaufen. Sie können es später erneut versuchen.
blockedDer Empfängerserver hat die Nachricht selbst abgelehnt: Spamfilter, Richtlinie, Blocklist oder Authentifizierung (5.7.x). Die Adresse ist in Ordnung, entfernen Sie sie also nicht: Korrigieren Sie, was gesendet wurde.
complaintDer Empfänger hat die E-Mail als Spam markiert (Feedback Loop) oder als Missbrauch gemeldet. Senden Sie nicht mehr an diese Adresse.
droppedSendcorex hat sie nie gesendet: Konto gesperrt, keine Credits oder ungültige Adresse.
Quellen
smtpDie Antwort des Empfängerservers während der Zustellung.
dsnEine Bounce-Nachricht, die später am Return-Path eintraf, nachdem der Server die E-Mail zunächst angenommen hatte.
expiredDie E-Mail war nach 5 Tagen noch in der Warteschlange und wurde aufgegeben.
retries_exhaustedDer Empfängerserver hat sie immer wieder zurückgestellt, und alle Wiederholungsversuche wurden verbraucht.
outgoingVor dem Senden gestoppt (das tragen
dropped-Ereignisse).fbl_microsoft / fbl_yahoo / fbl_otherEine Spam-Meldung aus dem Feedback Loop des Anbieters (Outlook/Hotmail, Yahoo/AOL, andere).
abuse_mailboxJemand hat an die Missbrauchsadresse im
X-Report-Abuse-Header der E-Mail geschrieben.abuse_webJemand hat die im
X-Report-Abuse-Header verlinkte Meldeseite verwendet.
Polling
Speichern Sie den Cursor an einem Ort, der einen Neustart übersteht (eine Datenbankzeile, eine Datei). Lesen Sie bei jedem Durchlauf, bis has_more false ist, verarbeiten Sie jedes Ereignis und speichern Sie den neuen Cursor.
Node.js
let cursor = await loadCursor(); // null the first time
async function poll() {
let more = true;
while (more) {
const [result] = await call({
command: 'list_feedback',
args: cursor ? { cursor, limit: 500 } : { since: new Date(Date.now() - 86400_000).toISOString(), limit: 500 },
});
for (const e of result.data.events) {
if (e.kind === 'bounce_hard' || e.kind === 'complaint') await suppress(e.recipient, e.kind); // your code
}
cursor = result.data.next_cursor;
await saveCursor(cursor);
more = result.data.has_more;
}
}
setInterval(poll, 30_000);call ist ein beliebiger Helper, der { commands: [...] } per POST an /v1/feedback sendet und results zurückgibt, wie in Run Commands.
Entfernen Sie Adressen nur bei bounce_hard und complaint. Ein blocked-Ereignis bedeutet, dass der Server diese Nachricht abgelehnt hat, nicht dass die Adresse schlecht ist.
Lieber Push? Die Webhooks bounced und fbl_complaint liefern dieselben Ereignisse in dem Moment, in dem sie passieren. Polling ist das Sicherheitsnetz, wenn Ihr Endpoint nicht erreichbar war.
Nach Typ filtern
Mit kinds bewegt sich der Cursor trotzdem über die herausgefilterten Ereignisse hinweg, sodass eine gefilterte Schleife genauso günstig ist wie eine ungefilterte.
Request-Body
{
"commands": [
{
"command": "list_feedback",
"args": {
"since": "2026-10-01T00:00:00Z",
"kinds": [
"complaint"
]
}
}
]
}Das Ereignis
Ereignis
{
"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"
}Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat `feedback:read` nicht.
- CMD
INVALID_ARGSEin Argument ist ungültig: unbekannter Typ, `since` nicht im Format RFC 3339, limit außerhalb des Bereichs, fehlende `email_id`…
- CMD
INVALID_CURSORDer Cursor ist fehlerhaft oder stammt aus einem anderen Konto. Beginnen Sie ohne Cursor (oder mit `since`) neu.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.