Logs: Lesen
Logs auflisten
Ihre Zustell-Logs, neueste zuerst, bis zu 50 pro Seite. Filtern Sie nach Status, Empfänger, Betreff, Domain, Absender und Datum, in beliebiger Kombination.
https://g.sendcorex.com/v1/logscommand: list_logsErfordert den Scope logs:read für Ihren API key.
Filter werden mit AND kombiniert. Ohne after erhalten Sie die letzten 60 Tage, so lange werden Logs aufbewahrt.
Warm-up-E-Mails erscheinen hier nie, und der E-Mail-Body ist nie Teil einer Liste. Verwenden Sie Get Logs mit include_content, um eine zu lesen.
Argumente
statusstring | string[]optionaldelivered,bounced,spam,rate_limitedodernot_sent, oder eine Liste davon. Ohne Angabe erhalten Sie alle fünf.z. B.
"bounced"recipientstringoptionalEine vollständige E-Mail-Adresse. Groß-/Kleinschreibung und umgebende Leerzeichen werden ignoriert.
z. B.
"ana@acme.com"subjectstringoptionalWörter aus dem Betreff. Ganze Wörter, und alle müssen vorkommen:
order shippedfindet "Your order #1042 has shipped",ordnicht. Akzente und Groß-/Kleinschreibung werden ignoriert.z. B.
"order shipped"searchstringoptionalFreitext, für ein Suchfeld. Mit einem
@ist es ein Empfänger, sonst sind es Betreffwörter.z. B.
"ana@acme.com"domainstringoptionalDie Empfänger-Domain, exakt.
z. B.
"gmail.com"fromstringoptionalDie Absenderadresse, exakt.
z. B.
"noreply@yourdomain.com"afterstring | numberoptionalNur Logs, die zu oder nach diesem Zeitpunkt gesendet wurden. ISO 8601,
YYYY-MM-DD(Mitternacht UTC) oder Epoch-Millisekunden. Standard: vor 60 Tagen.z. B.
"2026-10-01"beforestring | numberoptionalNur Logs, die vor diesem Zeitpunkt gesendet wurden. Gleiche Formate.
z. B.
"2026-10-17T00:00:00Z"limitnumberoptionalSeitengröße, von 1 bis 50. Standard: 50.
z. B.
50cursorstringoptionalDer
next_cursorder vorherigen Seite. Senden Sie ihn mit denselben Filtern.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/logs',
{
commands: [
{
command: "list_logs",
args: {
status: "bounced",
after: "2026-10-01",
limit: 50
}
}
]
},
{ 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_logs",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"logs": [
{
"id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"to": "old.address@gmail.com",
"from": "noreply@yourdomain.com",
"domain": "gmail.com",
"from_domain": "yourdomain.com",
"subject": "Your order #1042 has shipped",
"status": "bounced",
"status_code": 6,
"response": "550 5.1.1 The email account that you tried to reach does not exist.",
"message": null,
"blocked": false,
"block_reason": null,
"retries": 0,
"tracking_id": "7CK-JDL-Z2M-20261017",
"sent_at": "2026-10-17T05:58:44.031Z",
"updated_at": "2026-10-17T05:58:45.600Z"
}
],
"count": 1,
"has_more": true,
"next_cursor": "MDAwMDAwMDA4MzowOjgyMzkzMTU5OTg3OTU6M2YyYTFi",
"partial": false,
"total": 1240,
"total_exact": true
}
}
]
}Antwortfelder
logsDie Logs dieser Seite, neueste zuerst. Jedes hat die unten stehenden Felder.
countWie viele Logs auf dieser Seite sind.
has_more / next_cursorSolange
has_moretrueist, senden Sienext_cursoralscursormit denselben Filtern.partialtrue, wenn die Suche ihr Zeitlimit erreicht hat, bevor die Seite voll war. Die Seite kann weniger Logs enthalten, sogar null, undnext_cursormacht dort weiter, wo sie aufgehört hat.total / total_exactWie viele Logs zu den Filtern passen, nur auf der ersten Seite (die Anfrage ohne
cursor). Auf den folgenden Seiten sind beidenull, behalten Sie also den ersten Wert.totalist nur dann eine Zahl, wenn sie exakt ist (total_exact: true). Beitotal: nullundtotal_exact: falsesind es zu viele zum Zählen; sind beidenull, kann die Suche nicht gezählt werden (zum Beispiel ein Betreff ohne indexierbares Wort). In beiden Fällen blättern Sie weiter mithas_more.logs[].idDie E-Mail-ID (eine UUID). Es ist die
id, die Sie beim Senden erhalten, und die Sie an Get Logs übergeben.logs[].to / logs[].domainDer Empfänger und die Domain des Empfängers.
logs[].from_domainDie Domain des Absenders (der Teil nach dem @ in
from).logs[].fromDie Absenderadresse.
logs[].subjectDie Betreffzeile.
logs[].statusdelivered,bounced,spam,rate_limitedodernot_sent.status_codeist dasselbe als Zahl.logs[].responseWas der Empfängerserver geantwortet hat, zum Beispiel
250 2.0.0 OKoder der550-Bounce-Grund.logs[].messageZusätzliche Details von Sendcorex zur Zustellung, falls vorhanden.
logs[].blocked / logs[].block_reasontrue, wenn Sendcorex nicht an diesen Empfänger gesendet hat (unterdrückt oder eingeschränkt), und der Grund.logs[].retriesWie oft die Zustellung erneut versucht wurde.
logs[].tracking_idDie interne Zustell-ID. Bounce- und Beschwerde-Webhooks tragen denselben Wert.
logs[].sent_at / logs[].updated_atWann die E-Mail gesendet wurde und wann sich ihr Status zuletzt geändert hat. ISO 8601, UTC.
Status
deliveredDer Empfängerserver hat die E-Mail angenommen.
bouncedDer Empfängerserver hat sie endgültig abgelehnt: Die Adresse existiert nicht, die Domain nimmt keine E-Mails an…
spamDer Empfängerserver hat sie als Spam abgelehnt.
rate_limitedDer Empfängerserver hat sie immer wieder zurückgestellt, und die Wiederholungsversuche waren aufgebraucht.
not_sentWegen Ihres Kontos nicht gesendet (zum Beispiel keine Credits mehr, gesperrtes oder eingeschränktes Konto, Absenderdomain bei Spamhaus gelistet oder ohne DKIM, oder ungültiges From). Das ist kein Bounce. Der genaue Grund steht in
response.
E-Mails, die noch auf einen erneuten Versuch warten, sind hier noch nicht zu sehen: Sie erscheinen, sobald sie einen dieser fünf Status erreichen.
Paginierung
Machen Sie weiter, solange has_more true ist. Hören Sie nicht bei einer kurzen oder leeren Seite auf: Wenn partial true ist, ist der Suche bei diesem Aufruf die Zeit ausgegangen, nicht die Logs.
Node.js
const logs = [];
let cursor;
do {
const [result] = await call({
command: 'list_logs',
args: { status: 'bounced', after: '2026-10-01', ...(cursor ? { cursor } : {}) },
});
logs.push(...result.data.logs);
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);call ist ein beliebiger Helper, der { commands: [...] } per POST an /v1/logs sendet und results zurückgibt, wie in Run Commands.
Ein Cursor funktioniert nur mit den Filtern, aus denen er stammt. Ändern Sie einen Filter, erhalten Sie INVALID_CURSOR: Beginnen Sie ohne Cursor neu.
Neue Bounces beobachten
Um auf Bounces (oder alles andere) zu reagieren, sobald sie passieren, pollen Sie mit after auf dem neuesten sent_at, das Sie gesehen haben. after schließt diesen Zeitpunkt ein, daher kommt das letzte Log noch einmal zurück: Überspringen Sie IDs, die Sie bereits haben.
Node.js
const seen = new Set();
let since = new Date(Date.now() - 3600_000).toISOString(); // start with the last hour
setInterval(async () => {
let cursor;
do {
const [result] = await call({
command: 'list_logs',
args: { status: 'bounced', after: since, ...(cursor ? { cursor } : {}) },
});
for (const log of result.data.logs) {
if (seen.has(log.id)) continue;
seen.add(log.id);
if (log.sent_at > since) since = log.sent_at;
await removeFromMyList(log.to, log.response); // your code
}
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);
}, 10_000);Identische Lesezugriffe innerhalb von 1,5 Sekunden teilen sich ein Ergebnis, daher erzeugen mehrere Worker, die dasselbe abfragen, keine zusätzliche Last. Wenn Sie das Ereignis im selben Moment brauchen, verwenden Sie stattdessen den Webhook bounced.
Weitere Beispiele
Request-Body
{
"commands": [
{
"command": "list_logs",
"id": "ana",
"args": {
"recipient": "ana@acme.com"
}
},
{
"command": "list_logs",
"id": "shipped",
"args": {
"subject": "order shipped",
"status": "delivered",
"after": "2026-10-10"
}
},
{
"command": "list_logs",
"id": "gmail_spam",
"args": {
"domain": "gmail.com",
"status": [
"spam",
"bounced"
]
}
},
{
"command": "list_logs",
"id": "one_day",
"args": {
"after": "2026-10-16",
"before": "2026-10-17",
"limit": 20
}
}
]
}Das Log
List Logs und Get Logs liefern dieselbe Struktur.
Log
{
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"to": "ana@acme.com",
"from": "noreply@yourdomain.com",
"domain": "acme.com",
"from_domain": "yourdomain.com",
"subject": "Your order #1042 has shipped",
"status": "delivered",
"status_code": 2,
"response": "250 2.0.0 OK 1760684401 a1si123456",
"message": null,
"blocked": false,
"block_reason": null,
"retries": 0,
"tracking_id": "7CK-JDL-Y1L-20261017",
"sent_at": "2026-10-17T06:00:01.204Z",
"updated_at": "2026-10-17T06:00:02.913Z"
}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 `logs:read` nicht.
- CMD
INVALID_ARGSEin Argument ist ungültig: unbekannter Status, Empfänger ohne vollständige E-Mail-Adresse, limit außerhalb des Bereichs, ID, die keine UUID ist, after später als before…
- CMD
INVALID_CURSORDer Cursor ist fehlerhaft oder stammt aus einer anderen Suche oder einem anderen Konto. Beginnen Sie ohne Cursor neu.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.