API Timeline Jaringan Penipuan

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

Ambil riwayat event untuk sebuah jaringan. Tanpa contract, respons berisi riwayat jaringan itu sendiri, dari yang paling lama, dan tidak dipaginasi: kapan pertama kali terdeteksi, kapan setiap sinyal terakhir diamati, serta perubahan status terakhirnya beserta alasannya. Bentuk ini tidak berubah, dan limit, cursor serta event_type diabaikan.

Linimasa bertipe

Berikan contract=2 untuk membaca linimasa bertipe. Linimasa ini menambahkan apa yang dilakukan akun anggota dan apa yang dilakukan tim Anda terhadap jaringan, dari yang paling baru, satu halaman setiap kali. contract hanya menerima 2; nilai lain mengembalikan 400.

Parameter	Arti
`limit`	Event per halaman, 1 sampai 500. Defaultnya 100.
`cursor`	`next_cursor` dari halaman sebelumnya. Cursor yang tidak valid atau kosong mengembalikan `400`.
`event_type`	Tipe event yang ingin ditampilkan, diulang atau dipisahkan koma, paling banyak 20 nilai. Defaultnya semua tipe.

Respons berbentuk {"results": [...], "next_cursor": "..."}. Baca halaman berikutnya dengan cursor diisi next_cursor, sampai next_cursor bernilai null.

Tipe event

`event_type`	Yang dicatat	Blok detail
`network_detected`	Jaringan terdeteksi	Tidak ada
`signal_observed`	Pengamatan terbaru dari sebuah sinyal	Tidak ada
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	Perubahan status terbaru jaringan, dengan alasannya di `metadata`	Tidak ada
`verification_attempt`	Sesi verifikasi sebuah anggota (orang atau bisnis), diberi nomor (`attempt` dari `attempt_count`), beserta alasan penolakannya jika ditolak	`verification_attempt`
`transaction`	Transaksi yang melibatkan seorang anggota, bertanggal sesuai tanggal transaksinya	`transaction`
`login`	Masuk atau percobaan masuk yang gagal yang Anda kirim untuk sebuah anggota melalui API event	`login`
`rule_hit`	Aturan aktif yang cocok dengan transaksi atau event sebuah anggota	`rule_hit`
`case_linked`	Kasus yang dibuka untuk jaringan di organisasi Anda	`case_linked`
`note_added`	Catatan yang ditambahkan ke jaringan, tanpa teksnya	`note_added`

Event note_added hanya dikembalikan kepada anggota konsol, tidak pernah kepada kunci API. Transaksi antara dua anggota muncul satu kali untuk masing-masing, dengan account sendiri-sendiri. Kecocokan aturan pada transaksi itu muncul satu kali. Event login hanya ada untuk masuk yang Anda kirim sebagai event: auth.login, security.login_succeeded dan bentuk gagalnya.

Akun dan catatan

Setiap event anggota membawa account, yaitu anggota pemiliknya, dan source_ref, yaitu sesi, sesi bisnis, transaksi, event pemantauan, atau kasus yang menjadi sumber pembacaan event tersebut. ownership bernilai owned jika catatan itu milik aplikasi yang Anda panggil, dan organization jika milik aplikasi lain di organisasi Anda. route memuat jenis catatan, UUID, dan aplikasinya; source_ref tidak memiliki route untuk event pemantauan atau kasus. Event milik jaringan itu sendiri tidak memiliki account maupun source_ref.

Terkait

Otorisasi

x-api-key

string

header

wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

organization_id

string<uuid>

wajib

UUID organisasi.

application_id

string<uuid>

wajib

UUID aplikasi.

network_uuid

string<uuid>

wajib

UUID jaringan.

Contoh:

"n3a5e000-0000-4000-8000-000000000001"

Parameter Query

contract

enum<string>

2 mengembalikan linimasa bertipe. Jangan sertakan nilai ini untuk linimasa default. Nilai lainnya mengembalikan 400.

Opsi yang tersedia:

2

limit

integer

default:100

Khusus linimasa bertipe. Event per halaman, 1 hingga 500. Default ke 100.

Rentang yang diperlukan: 1 <= x <= 500

cursor

string

Khusus linimasa bertipe. Nilai next_cursor dari halaman sebelumnya. Kursor yang tidak valid atau kosong mengembalikan 400.

event_type

enum<string>[]

Khusus linimasa bertipe. Jenis event yang akan disimpan, diulang atau dipisahkan koma, maksimal 20 nilai. Default ke semua jenis.

Maximum array length: 20

Opsi yang tersedia:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Respons

Tanpa contract: {results}, yang terlama lebih dulu, tidak dipaginasi. Dengan contract=2: {results, next_cursor}, yang terbaru lebih dulu.

Default timeline (no contract)
Typed timeline page (contract=2)

Tanpa contract: event milik jaringan itu sendiri, terlama lebih dulu, tanpa paginasi.

results

object[]

Show child attributes

Terakhir diubah pada 7 November 2026

​Linimasa bertipe

​Tipe event

​Akun dan catatan

​Terkait

Otorisasi

Parameter Path

Parameter Query

Respons

Linimasa bertipe

Tipe event

Akun dan catatan

Terkait