Kontak: aktivitas

Daftar event

Riwayat satu kontak, terbaru lebih dulu: pengiriman, open, klik, bounce, keluhan, dan berhenti berlangganan.

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

Membutuhkan scope contact:read pada API key Anda.

i

Event dicatat oleh pengiriman dan tracking. API hanya membacanya.

Argumen

  • emailstringwajib

    Kontaknya.

    mis. "ana@acme.com"

  • typesstring[]opsional

    Hanya tipe ini: sent, open, click, bounce, complaint, unsubscribe.

    mis. ["open", "click"]

  • limitnumberopsional

    Ukuran halaman, dari 1 sampai 1000. Default 50.

  • cursorstringopsional

    next_cursor dari halaman sebelumnya.

Mulai cepat

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

Respons

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

Field respons

  • events[].type

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

  • events[].at

    Kapan terjadinya.

  • events[].campaign_id / list_id

    Kampanye dan list asal email tersebut, jika diketahui.

  • events[].url

    Tautannya, pada event click.

  • events[].ip / user_agent

    Asal open atau klik tersebut.

  • events[].by_proxy

    true jika open berasal dari proxy privasi email, bukan dari orangnya.

  • events[].reason / hard

    Pada bounce: alasannya, dan apakah itu hard bounce.

  • has_more / next_cursor

    Paginasi. Kirim next_cursor sebagai cursor untuk mendapatkan event yang lebih lama.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401INVALID_API_KEY

    API key tidak ada, sudah dicabut, atau dinonaktifkan di dashboard.

  • 429RATE_LIMITED

    Lebih dari 15 request/detik atau 15 bersamaan untuk IP + API key yang sama. Tunggu sesuai jumlah detik di Retry-After.

  • CMDMISSING_SCOPE

    API key tidak memiliki scope yang dibutuhkan perintah ini. Perintah lain dalam request tetap berjalan.

  • CMDINVALID_ARGS

    Argumen wajib tidak ada atau tidak valid: email, nilai field, opsi enum, key where, id list…

  • CMDINVALID_CURSOR

    Cursor tidak valid atau milik query atau akun lain.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.