Kontakte: Aktivität

Ereignisse auflisten

Die Historie eines Kontakts, neueste zuerst: Sendungen, Öffnungen, Klicks, Bounces, Beschwerden und Abmeldungen.

POSThttps://g.sendcorex.com/v1/contactscommand: list_events
i

Erfordert den Scope contact:read auf Ihrem API Key.

i

Ereignisse werden durch Versand und Tracking erfasst. Die API liest sie nur.

Argumente

  • emailstringerforderlich

    Der Kontakt.

    z. B. "ana@acme.com"

  • typesstring[]optional

    Nur diese Typen: sent, open, click, bounce, complaint, unsubscribe.

    z. B. ["open", "click"]

  • limitnumberoptional

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

  • cursorstringoptional

    Der next_cursor der vorherigen Seite.

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/contacts',
  {
    commands: [
      {
        command: "list_events",
        args: {
          email: "ana@acme.com",
          types: [
            "open",
            "click"
          ],
          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_events",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 14,
      "data": {
        "events": [
          {
            "event_id": "ev_7c1d02",
            "type": "click",
            "at": "2026-10-14T21:04:10.000Z",
            "campaign_id": "cmp_october",
            "list_id": "customers",
            "url": "https://acme.com/offer",
            "ip": "203.0.113.24",
            "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X)",
            "reason": null,
            "by_proxy": false,
            "hard": null,
            "meta": null
          },
          {
            "event_id": "ev_7c1cf9",
            "type": "open",
            "at": "2026-10-14T21:03:55.000Z",
            "campaign_id": "cmp_october",
            "list_id": "customers",
            "url": null,
            "ip": "203.0.113.24",
            "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X)",
            "reason": null,
            "by_proxy": false,
            "hard": null,
            "meta": null
          }
        ],
        "has_more": true,
        "next_cursor": "eyJ0IjoxNzYwNDc1ODM1fQ"
      }
    }
  ]
}

Antwortfelder

  • events[].type

    sent, open, click, bounce, complaint oder unsubscribe.

  • events[].at

    Wann es passiert ist.

  • events[].campaign_id / list_id

    Die Kampagne und Liste, zu der die E-Mail gehörte, sofern bekannt.

  • events[].url

    Der Link, bei click-Ereignissen.

  • events[].ip / user_agent

    Woher die Öffnung oder der Klick kam.

  • events[].by_proxy

    true, wenn die Öffnung von einem Mail-Privacy-Proxy statt von der Person kam.

  • events[].reason / hard

    Bei bounce: der Grund und ob es ein Hard Bounce war.

  • has_more / next_cursor

    Paginierung. Senden Sie next_cursor als cursor, um ältere Ereignisse zu erhalten.

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 Sekunden aus Retry-After ab.

  • CMDMISSING_SCOPE

    Dem API Key fehlt der Scope, den dieser Befehl braucht. Die anderen Befehle im Request laufen trotzdem.

  • CMDINVALID_ARGS

    Ein Pflichtargument fehlt oder ist ungültig: E-Mail, Feldwert, Enum-Option, where-Schlüssel, Listen-ID …

  • CMDINVALID_CURSOR

    Der Cursor ist fehlerhaft oder gehört zu einer anderen Abfrage oder einem anderen Konto.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.