Logs

Wissen, was mit jeder E-Mail passiert ist

Durchsuchen Sie Ihre Zustellungen nach Status, Empfänger, Betreff und Datum, lesen Sie jede E-Mail per ID und beobachten Sie Bounces, sobald sie eintreffen, alles über einen einzigen Endpoint.

  • JSON-Befehle
  • 50 pro Seite
  • Filtern und suchen
  • Letzte 60 Tage
  • Nur Lesezugriff
POSThttps://g.sendcorex.com/v1/logslogs:read

So funktioniert es

Ein Log pro E-Mail

Jede E-Mail, die Sie senden, erhält ein Log mit Empfänger, Betreff, Status und der Antwort des Empfängerservers. Die ID ist dieselbe, die Sie beim Senden erhalten haben.

Ein Endpoint, zwei Befehle

list_logs durchsucht und paginiert Ihre Logs; get_logs liest sie per ID. Beide gehen an POST /v1/logs, bis zu 20 Befehle pro Request.

Für Polling gemacht

Fragen Sie alle paar Sekunden nach neuen Bounces, ohne sich um Last zu sorgen: wiederholte Lesezugriffe teilen sich ein Ergebnis, und Warm-up-E-Mails stören nie.

Erste Schritte

Vor Ihrem ersten Request brauchen Sie nur den Key.

  1. 1

    API key mit logs:read erstellen

    Öffnen Sie im Dashboard Developers → API Keys und erstellen Sie einen Key mit dem Scope logs:read. Sie können ihn auch einem Key hinzufügen, den Sie bereits zum Senden verwenden.

    Der Webmail-Token funktioniert hier nicht. Logs verwenden den API key aus dem Dashboard.

  2. 2

    Logs durchsuchen

    List Logs akzeptiert jede Kombination aus Status, Empfänger, Betreffwörtern, Domain, Absender und Datum und liefert 50 Logs pro Seite.

  3. 3

    Eine E-Mail lesen

    Get Logs liest bis zu 50 Logs per ID. Fügen Sie include_content hinzu, um das zugestellte HTML zu sehen.

Das Log

Beide Befehle liefern Logs in dieser Struktur.

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

delivered, bounced, spam oder rate_limited. Filtern Sie nach einem oder mehreren.

response

Die genaue Antwort des Empfängerservers. Bei einem Bounce steht dort der Grund.

blocked

true, wenn Sendcorex nicht an diese Adresse gesendet hat, zum Beispiel weil sie unterdrückt ist.

content

Standardmäßig nicht Teil des Logs. Get Logs liefert das HTML mit include_content.

Ihr erster Request

Zwei Suchen in einem Request: Ihre Bounces dieses Monats und die letzten E-Mails an einen Kunden. Ersetzen Sie SENDCOREX_API_KEY durch Ihren API key.

curl -X POST 'https://g.sendcorex.com/v1/logs' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_logs", "args": { "status": "bounced", "after": "2026-10-01" } },
    { "command": "list_logs", "args": { "recipient": "ana@acme.com", "limit": 10 } }
  ]
}'

Sie erhalten ein Ergebnis pro Befehl, jedes mit seinen logs und einem next_cursor für die nächste Seite. Derselbe Request in 8 Sprachen steht in List Logs.

Häufige Aufgaben

Bounces aus Ihrer Liste entfernen

Fragen Sie alle paar Sekunden bounced-Logs ab, mit after auf dem zuletzt gesehenen, und entfernen Sie diese Adressen auf Ihrer Seite.

Neue Bounces beobachten

„Ist meine E-Mail angekommen?“ beantworten

Suchen Sie einen Kunden nach Empfänger und zeigen Sie Status und Serverantwort seiner letzten E-Mails an.

List Logs

Einen Versand prüfen

Speichern Sie die ID, die Sie beim Senden erhalten, und lesen Sie das Log später mit Get Logs.

Get Logs

Sehen, was zugestellt wurde

Get Logs mit include_content liefert das HTML, für Support-Ansichten oder Audits.

Den Body lesen

Vollständige Referenz

Alles mit CMD ist ein Befehl, der über POST /v1/logs gesendet wird, bis zu 20 pro Request.