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.

POSThttps://g.sendcorex.com/v1/logscommand: list_logs
i

Erfordert den Scope logs:read für Ihren API key.

i

Filter werden mit AND kombiniert. Ohne after erhalten Sie die letzten 60 Tage, so lange werden Logs aufbewahrt.

i

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[]optional

    delivered, bounced, spam, rate_limited oder not_sent, oder eine Liste davon. Ohne Angabe erhalten Sie alle fünf.

    z. B. "bounced"

  • recipientstringoptional

    Eine vollständige E-Mail-Adresse. Groß-/Kleinschreibung und umgebende Leerzeichen werden ignoriert.

    z. B. "ana@acme.com"

  • subjectstringoptional

    Wörter aus dem Betreff. Ganze Wörter, und alle müssen vorkommen: order shipped findet "Your order #1042 has shipped", ord nicht. Akzente und Groß-/Kleinschreibung werden ignoriert.

    z. B. "order shipped"

  • searchstringoptional

    Freitext, für ein Suchfeld. Mit einem @ ist es ein Empfänger, sonst sind es Betreffwörter.

    z. B. "ana@acme.com"

  • domainstringoptional

    Die Empfänger-Domain, exakt.

    z. B. "gmail.com"

  • fromstringoptional

    Die Absenderadresse, exakt.

    z. B. "noreply@yourdomain.com"

  • afterstring | numberoptional

    Nur 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 | numberoptional

    Nur Logs, die vor diesem Zeitpunkt gesendet wurden. Gleiche Formate.

    z. B. "2026-10-17T00:00:00Z"

  • limitnumberoptional

    Seitengröße, von 1 bis 50. Standard: 50.

    z. B. 50

  • cursorstringoptional

    Der next_cursor der 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

  • logs

    Die Logs dieser Seite, neueste zuerst. Jedes hat die unten stehenden Felder.

  • count

    Wie viele Logs auf dieser Seite sind.

  • has_more / next_cursor

    Solange has_more true ist, senden Sie next_cursor als cursor mit denselben Filtern.

  • partial

    true, wenn die Suche ihr Zeitlimit erreicht hat, bevor die Seite voll war. Die Seite kann weniger Logs enthalten, sogar null, und next_cursor macht dort weiter, wo sie aufgehört hat.

  • total / total_exact

    Wie viele Logs zu den Filtern passen, nur auf der ersten Seite (die Anfrage ohne cursor). Auf den folgenden Seiten sind beide null, behalten Sie also den ersten Wert. total ist nur dann eine Zahl, wenn sie exakt ist (total_exact: true). Bei total: null und total_exact: false sind es zu viele zum Zählen; sind beide null, kann die Suche nicht gezählt werden (zum Beispiel ein Betreff ohne indexierbares Wort). In beiden Fällen blättern Sie weiter mit has_more.

  • logs[].id

    Die E-Mail-ID (eine UUID). Es ist die id, die Sie beim Senden erhalten, und die Sie an Get Logs übergeben.

  • logs[].to / logs[].domain

    Der Empfänger und die Domain des Empfängers.

  • logs[].from_domain

    Die Domain des Absenders (der Teil nach dem @ in from).

  • logs[].from

    Die Absenderadresse.

  • logs[].subject

    Die Betreffzeile.

  • logs[].status

    delivered, bounced, spam, rate_limited oder not_sent. status_code ist dasselbe als Zahl.

  • logs[].response

    Was der Empfängerserver geantwortet hat, zum Beispiel 250 2.0.0 OK oder der 550-Bounce-Grund.

  • logs[].message

    Zusätzliche Details von Sendcorex zur Zustellung, falls vorhanden.

  • logs[].blocked / logs[].block_reason

    true, wenn Sendcorex nicht an diesen Empfänger gesendet hat (unterdrückt oder eingeschränkt), und der Grund.

  • logs[].retries

    Wie oft die Zustellung erneut versucht wurde.

  • logs[].tracking_id

    Die interne Zustell-ID. Bounce- und Beschwerde-Webhooks tragen denselben Wert.

  • logs[].sent_at / logs[].updated_at

    Wann die E-Mail gesendet wurde und wann sich ihr Status zuletzt geändert hat. ISO 8601, UTC.

Status

  • delivered

    Der Empfängerserver hat die E-Mail angenommen.

  • bounced

    Der Empfängerserver hat sie endgültig abgelehnt: Die Adresse existiert nicht, die Domain nimmt keine E-Mails an…

  • spam

    Der Empfängerserver hat sie als Spam abgelehnt.

  • rate_limited

    Der Empfängerserver hat sie immer wieder zurückgestellt, und die Wiederholungsversuche waren aufgebraucht.

  • not_sent

    Wegen 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.

i

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);
i

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);
i

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.

  • 401INVALID_API_KEY

    Der API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.

  • 429RATE_LIMITED

    Mehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.

  • CMDMISSING_SCOPE

    Der API key hat `logs:read` nicht.

  • CMDINVALID_ARGS

    Ein 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…

  • CMDINVALID_CURSOR

    Der Cursor ist fehlerhaft oder stammt aus einer anderen Suche oder einem anderen Konto. Beginnen Sie ohne Cursor neu.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.