Logs: Membaca

Daftar log

Log pengiriman Anda, terbaru lebih dulu, hingga 50 per halaman. Filter berdasarkan status, penerima, subjek, domain, pengirim, dan tanggal, dalam kombinasi apa pun.

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

Membutuhkan scope logs:read pada API key Anda.

i

Filter digabungkan dengan AND. Tanpa after, Anda mendapatkan 60 hari terakhir, yaitu lamanya log disimpan.

i

Email warm-up tidak pernah muncul di sini, dan body email tidak pernah menjadi bagian dari daftar. Gunakan Get Logs dengan include_content untuk membacanya.

Argumen

  • statusstring | string[]opsional

    delivered, bounced, spam, rate_limited, atau not_sent, atau daftar dari nilai-nilai itu. Tanpa ini Anda mendapatkan kelimanya.

    mis. "bounced"

  • recipientstringopsional

    Alamat email lengkap. Huruf besar/kecil dan spasi di sekitarnya diabaikan.

    mis. "ana@acme.com"

  • subjectstringopsional

    Kata-kata dari subjek. Kata utuh, dan semua kata harus ada: order shipped menemukan "Your order #1042 has shipped", ord tidak. Aksen dan huruf besar/kecil diabaikan.

    mis. "order shipped"

  • searchstringopsional

    Teks bebas, untuk kotak pencarian. Jika ada @ dianggap penerima, selain itu dianggap kata di subjek.

    mis. "ana@acme.com"

  • domainstringopsional

    Domain penerima, persis.

    mis. "gmail.com"

  • fromstringopsional

    Alamat pengirim, persis.

    mis. "noreply@yourdomain.com"

  • afterstring | numberopsional

    Hanya log yang dikirim pada atau setelah saat ini. ISO 8601, YYYY-MM-DD (tengah malam UTC), atau epoch dalam milidetik. Default-nya 60 hari yang lalu.

    mis. "2026-10-01"

  • beforestring | numberopsional

    Hanya log yang dikirim sebelum saat ini. Format yang sama.

    mis. "2026-10-17T00:00:00Z"

  • limitnumberopsional

    Ukuran halaman, dari 1 hingga 50. Default-nya 50.

    mis. 50

  • cursorstringopsional

    next_cursor dari halaman sebelumnya. Kirim dengan filter yang sama.

Mulai cepat

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

Respons

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

Field respons

  • logs

    Log di halaman ini, terbaru lebih dulu. Masing-masing memiliki field di bawah.

  • count

    Jumlah log di halaman ini.

  • has_more / next_cursor

    Selama has_more bernilai true, kirim next_cursor sebagai cursor dengan filter yang sama.

  • partial

    true jika pencarian mencapai batas waktunya sebelum halaman terisi. Halaman bisa berisi lebih sedikit log, bahkan nol, dan next_cursor melanjutkan dari titik berhentinya.

  • total / total_exact

    Jumlah log yang cocok dengan filter, hanya di halaman pertama (permintaan tanpa cursor). Di halaman berikutnya keduanya bernilai null, jadi simpan nilai pertama. total hanya berisi angka jika jumlahnya pasti (total_exact: true). Dengan total: null dan total_exact: false, log terlalu banyak untuk dihitung; jika keduanya null, pencarian tidak bisa dihitung (misalnya subjek tanpa kata yang terindeks). Dalam kedua kasus, lanjutkan paginasi dengan has_more.

  • logs[].id

    ID email (sebuah UUID). Ini adalah id yang Anda terima saat mengirim, dan yang Anda berikan ke Get Logs.

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

    Penerima dan domain penerima.

  • logs[].from_domain

    Domain pengirim (bagian setelah @ di from).

  • logs[].from

    Alamat pengirim.

  • logs[].subject

    Baris subjek.

  • logs[].status

    delivered, bounced, spam, rate_limited, atau not_sent. status_code adalah hal yang sama dalam bentuk angka.

  • logs[].response

    Jawaban server penerima, misalnya 250 2.0.0 OK atau alasan bounce 550.

  • logs[].message

    Detail tambahan dari Sendcorex tentang pengiriman, jika ada.

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

    true jika Sendcorex tidak mengirim ke penerima ini (disupresi atau dibatasi), beserta alasannya.

  • logs[].retries

    Berapa kali pengiriman dicoba ulang.

  • logs[].tracking_id

    id pengiriman internal. Webhook bounce dan complaint membawa nilai yang sama.

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

    Kapan email dikirim, dan kapan statusnya terakhir berubah. ISO 8601, UTC.

Status

  • delivered

    Server penerima menerima email.

  • bounced

    Server penerima menolaknya secara permanen: alamatnya tidak ada, domainnya tidak menerima email…

  • spam

    Server penerima menolaknya sebagai spam.

  • rate_limited

    Server penerima terus menundanya dan percobaan ulang habis.

  • not_sent

    Tidak terkirim karena kondisi akun Anda (misalnya kredit habis, akun diblokir atau dibatasi, domain pengirim terdaftar di Spamhaus atau tanpa DKIM, atau From tidak valid). Ini bukan bounce. Alasan pastinya ada di response.

i

Email yang masih menunggu percobaan ulang belum ada di sini: email tersebut muncul saat mencapai salah satu dari lima status ini.

Paginasi

Lanjutkan selama has_more bernilai true. Jangan berhenti di halaman yang pendek atau kosong: jika partial bernilai true, pencarian kehabisan waktu pada panggilan itu, bukan kehabisan log.

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 adalah helper apa pun yang mem-POST { commands: [...] } ke /v1/logs dan mengembalikan results, seperti di Run Commands.

!

Cursor hanya berfungsi dengan filter asalnya. Ubah satu filter dan Anda mendapat INVALID_CURSOR: mulai lagi tanpa cursor.

Memantau bounce baru

Untuk bereaksi terhadap bounce (atau apa pun) saat terjadi, lakukan polling dengan after diatur ke sent_at terbaru yang pernah Anda lihat. after mencakup saat tersebut, jadi log terakhir kembali sekali lagi: lewati id yang sudah Anda miliki.

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

Pembacaan identik dalam 1,5 detik berbagi satu hasil, jadi beberapa worker yang mem-polling hal yang sama tidak menambah beban. Jika Anda butuh event tepat saat terjadi, gunakan webhook bounced.

Contoh lainnya

Body request

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

Log

List Logs dan Get Logs mengembalikan struktur yang sama.

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

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, telah dicabut, atau dinonaktifkan di dashboard.

  • 429RATE_LIMITED

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

  • CMDMISSING_SCOPE

    API key tidak memiliki `logs:read`.

  • CMDINVALID_ARGS

    Ada argumen yang tidak valid: status tidak dikenal, penerima bukan email lengkap, limit di luar rentang, id bukan UUID, after lebih lambat dari before…

  • CMDINVALID_CURSOR

    Cursor tidak valid, atau berasal dari pencarian atau akun lain. Mulai lagi tanpa cursor.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.