Bounces & Complaints: Lesen

E-Mail abrufen

Alles, was für eine E-Mail zurückkam: ihr Bounce oder ihre Blockierung, ihre Beschwerde oder warum sie nicht gesendet wurde. Ein Lookup, kein Scan.

POSThttps://g.sendcorex.com/v1/feedbackcommand: get_email
i

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

i

Eine E-Mail hat höchstens ein Ereignis pro Gruppe: einen Bounce (bounce_hard, bounce_soft oder blocked), ein complaint und ein dropped.

Argumente

  • email_idstringerforderlich

    Die E-Mail-ID, die id, die Sie beim Senden erhalten haben.

    z. B. "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"

Schnellstart

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

Antwort

{
  "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"
          }
        ]
      }
    }
  ]
}

Antwortfelder

  • events

    Die Ereignisse dieser E-Mail. Leer, wenn nichts zurückkam (die E-Mail wurde zugestellt oder ist älter als 90 Tage).

  • events[].email_id

    Die E-Mail-ID (eine UUID): die id, die Sie beim Senden erhalten haben, und dieselbe ID wie in Logs und Webhooks.

  • events[].kind

    Was passiert ist: bounce_hard, bounce_soft, blocked, complaint oder dropped. Siehe Typen unten.

  • events[].source

    Woher wir es wissen: die SMTP-Antwort, eine Bounce-Nachricht, ein Feedback Loop, eine Missbrauchsmeldung… Siehe Quellen unten.

  • events[].recipient

    Die Adresse, an die die E-Mail gesendet wurde.

  • events[].from

    Die Absenderadresse.

  • events[].campaign_id

    Die Kampagne, falls die E-Mail zu einer gehört.

  • events[].smtp_code / events[].enhanced_code

    Der Code, den der Empfängerserver geantwortet hat, zum Beispiel 550 und 5.1.1. Nur bei Bounces und Blockierungen.

  • events[].diagnostic

    Die vollständige Antwort des Empfängerservers oder der in einer Missbrauchsmeldung genannte Grund.

  • events[].reporting_mta

    Wer es gemeldet hat: der Server, der die Bounce-Nachricht gesendet hat, die Feedback-Loop-Adresse oder web für die Meldeseite.

  • events[].at

    Wann es passiert ist. ISO 8601, UTC.

„Warum ist meine E-Mail nicht angekommen?“ beantworten

Lesen Sie das Log und sein Feedback auf einmal: Logs nennt Ihnen den Status, dieser Befehl den Grund und wer es gemeldet hat.

Zwei Requests, dieselbe 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"
        }
      }
    ]
  }
}

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 `feedback:read` nicht.

  • CMDINVALID_ARGS

    Ein Argument ist ungültig: unbekannter Typ, `since` nicht im Format RFC 3339, limit außerhalb des Bereichs, fehlende `email_id`…

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.