Timeline Event Pemantauan API

curl

curl -X GET 'https://verification.didit.me/v3/events/subjects/user-42/?entity_type=individual&limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

for await (const item of didit.monitoringEvents.retrieveSubjectTimeline("user-42")) {
  console.log(item);
}

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.MonitoringEvents.RetrieveSubjectTimelineAutoPaging(ctx, "user-42", didit.MonitoringEventsRetrieveSubjectTimelineParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

foreach ($didit->monitoringEvents->retrieveSubjectTimeline('user-42') as $item) {
    print_r($item->toArray());
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

await foreach (var item in await client.MonitoringEvents.RetrieveSubjectTimelineAsync("user-42"))
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "event_uuid": "11111111-2222-3333-4444-555555555555",
      "event_id": "chargeback-2026-10-16-000318",
      "event_category": "dispute",
      "action_type": "chargeback_opened",
      "occurred_at": "2026-10-16T14:02:11Z",
      "received_at": "2026-10-16T14:02:12.418230Z",
      "status": "IN_REVIEW",
      "score": 60,
      "subject_vendor_data": "user-42",
      "subject_entity_type": "individual",
      "subject_uuid": "66666666-7777-8888-9999-000000000000",
      "counterparty_vendor_data": null,
      "session_id": null,
      "device_fingerprint": null,
      "ip_address": null,
      "ip_country": null,
      "amount": "250.000000000000000000",
      "currency": "EUR",
      "game_id": null,
      "round_id": null,
      "bonus_id": null,
      "affiliate_code": null,
      "payment_reference_id": "dep_735",
      "retention_class": "monetary_or_compliance",
      "rules_matched_count": 1,
      "correlation_pending": false,
      "is_droppable": false
    },
    {
      "event_uuid": "22222222-3333-4444-5555-666666666666",
      "event_id": "login-2026-10-15-000912",
      "event_category": "auth",
      "action_type": "login",
      "occurred_at": "2026-10-15T08:30:00.120000Z",
      "received_at": "2026-10-15T08:30:00.734512Z",
      "status": "ACCEPTED",
      "score": 0,
      "subject_vendor_data": "user-42",
      "subject_entity_type": "individual",
      "subject_uuid": "66666666-7777-8888-9999-000000000000",
      "counterparty_vendor_data": null,
      "session_id": "web-session-abc",
      "device_fingerprint": "fp-a8c1",
      "ip_address": "203.0.113.42",
      "ip_country": "ES",
      "amount": null,
      "currency": null,
      "game_id": null,
      "round_id": null,
      "bonus_id": null,
      "affiliate_code": null,
      "payment_reference_id": null,
      "retention_class": "standard",
      "rules_matched_count": 0,
      "correlation_pending": false,
      "is_droppable": true
    }
  ]
}

GET

events

subjects

{vendor_data}

curl

curl -X GET 'https://verification.didit.me/v3/events/subjects/user-42/?entity_type=individual&limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

for await (const item of didit.monitoringEvents.retrieveSubjectTimeline("user-42")) {
  console.log(item);
}

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.MonitoringEvents.RetrieveSubjectTimelineAutoPaging(ctx, "user-42", didit.MonitoringEventsRetrieveSubjectTimelineParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

foreach ($didit->monitoringEvents->retrieveSubjectTimeline('user-42') as $item) {
    print_r($item->toArray());
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

await foreach (var item in await client.MonitoringEvents.RetrieveSubjectTimelineAsync("user-42"))
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "event_uuid": "11111111-2222-3333-4444-555555555555",
      "event_id": "chargeback-2026-10-16-000318",
      "event_category": "dispute",
      "action_type": "chargeback_opened",
      "occurred_at": "2026-10-16T14:02:11Z",
      "received_at": "2026-10-16T14:02:12.418230Z",
      "status": "IN_REVIEW",
      "score": 60,
      "subject_vendor_data": "user-42",
      "subject_entity_type": "individual",
      "subject_uuid": "66666666-7777-8888-9999-000000000000",
      "counterparty_vendor_data": null,
      "session_id": null,
      "device_fingerprint": null,
      "ip_address": null,
      "ip_country": null,
      "amount": "250.000000000000000000",
      "currency": "EUR",
      "game_id": null,
      "round_id": null,
      "bonus_id": null,
      "affiliate_code": null,
      "payment_reference_id": "dep_735",
      "retention_class": "monetary_or_compliance",
      "rules_matched_count": 1,
      "correlation_pending": false,
      "is_droppable": false
    },
    {
      "event_uuid": "22222222-3333-4444-5555-666666666666",
      "event_id": "login-2026-10-15-000912",
      "event_category": "auth",
      "action_type": "login",
      "occurred_at": "2026-10-15T08:30:00.120000Z",
      "received_at": "2026-10-15T08:30:00.734512Z",
      "status": "ACCEPTED",
      "score": 0,
      "subject_vendor_data": "user-42",
      "subject_entity_type": "individual",
      "subject_uuid": "66666666-7777-8888-9999-000000000000",
      "counterparty_vendor_data": null,
      "session_id": "web-session-abc",
      "device_fingerprint": "fp-a8c1",
      "ip_address": "203.0.113.42",
      "ip_country": "ES",
      "amount": null,
      "currency": null,
      "game_id": null,
      "round_id": null,
      "bonus_id": null,
      "affiliate_code": null,
      "payment_reference_id": null,
      "retention_class": "standard",
      "rules_matched_count": 0,
      "correlation_pending": false,
      "is_droppable": true
    }
  ]
}

Lihat Membaca kembali event di panduan tentang cara memasukkan event. Untuk mencari di seluruh subjek, gunakan Daftar event pemantauan.

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

vendor_data

string

wajib

ID Anda untuk subjek (subject.vendor_data dari event-nya). Lakukan URL-encode; nilai yang mengandung / tidak dapat ditangani oleh endpoint ini.

Required string length: 1 - 255

Parameter Query

entity_type

enum<string>

default:individual

company mengembalikan perusahaan dengan vendor_data ini; nilai lain apa pun, atau tanpa nilai, mengembalikan individu. subject_entity_type diterima sebagai alias jika entity_type tidak ada.

Opsi yang tersedia:

individual,

company

limit

integer

default:50

Jumlah event maksimum per halaman. Defaultnya 50. Nilai di atas 1000000 mengembalikan 400; nilai non-numerik, nol, atau negatif akan dialihkan ke 50.

Rentang yang diperlukan: 1 <= x <= 1000000

offset

integer

default:0

Jumlah event yang dilewati. Default-nya 0. Lebih disarankan mengikuti URL next dari respons.

Rentang yang diperlukan: 0 <= x <= 1000000

event_category

enum<string>[]

Hanya event dalam kategori ini. Ulangi parameter untuk beberapa nilai (?event_category=payment&event_category=dispute); event yang cocok dengan salah satunya akan dikembalikan.

Opsi yang tersedia:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string[]

Hanya event dengan jenis tindakan ini (persis, peka huruf besar-kecil). Ulangi untuk beberapa nilai.

status

enum<string>[]

Hanya event dengan status ini. Ulangi untuk beberapa nilai.

Opsi yang tersedia:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

retention_class

enum<string>[]

Hanya event dalam kelas retensi ini. Ulangi untuk beberapa nilai.

Opsi yang tersedia:

low_value,

standard,

risk_relevant,

monetary_or_compliance

business_vendor_data

string

Kecocokan persis pada business.vendor_data yang dikirim bersama event.

session_id

string

Kecocokan persis pada session.session_id.

device_fingerprint

string

Kecocokan persis pada device_context.fingerprint.

ip_address

string

Kecocokan persis pada alamat IP peristiwa.

game_id

string

Kecocokan persis pada game_id yang dipromosikan.

round_id

string

Kecocokan persis pada round_id yang dipromosikan.

affiliate_code

string

Kecocokan persis pada affiliate_code yang dipromosikan.

payment_reference_id

string

Kecocokan persis pada referensi pembayaran (dari transaction_context.payment_reference_id atau payload.payment_reference_id).

counterparty_vendor_data

string

Kecocokan persis pada counterparty_vendor_data yang dipromosikan.

matched_only

boolean

default:false

true (juga 1 atau yes, tidak peka huruf besar/kecil) hanya mengembalikan event yang cocok dengan setidaknya satu aturan (rules_matched_count di atas 0). Nilai lainnya akan diabaikan.

occurred_from

string<date-time>

Hanya event dengan occurred_at pada atau setelah waktu ini (inklusif). Kirimkan nilai ISO 8601: 2026-10-01T00:00:00Z, offset eksplisit dengan tanda + yang di-percent-encode (2026-10-01T02:00:00%2B02:00; tanda + tanpa encoding akan didekodekan sebagai spasi dan nilainya tidak dapat lagi di-parse), atau tanggal saja (2026-10-01), yang berarti pukul 00:00:00 UTC pada hari tersebut. Nilai tanpa offset dibaca sebagai UTC. Nilai dalam format lainnya tidak diterima.

occurred_to

string<date-time>

Hanya event dengan occurred_at pada atau sebelum waktu ini (inklusif). Tanggal saja berarti awal hari tersebut, sehingga occurred_to=2026-10-15 tidak menyertakan sisa hari 15 Oktober; kirimkan 2026-10-15T23:59:59Z untuk menyertakannya. Kirimkan nilai ISO 8601: 2026-10-01T00:00:00Z, offset eksplisit dengan tanda + yang di-percent-encode (2026-10-01T02:00:00%2B02:00; tanda + tanpa encoding akan didekodekan sebagai spasi dan nilainya tidak dapat lagi di-parse), atau tanggal saja (2026-10-01), yang berarti pukul 00:00:00 UTC pada hari tersebut. Nilai tanpa offset dibaca sebagai UTC. Nilai dalam format lainnya tidak diterima.

string

Pencocokan substring yang tidak peka huruf besar/kecil pada event_id, action_type, subject_vendor_data, atau counterparty_vendor_data.

Respons

Satu halaman event subjek.

Satu halaman event pemantauan, occurred_at terbaru lebih dahulu.

count

integer

wajib

Jumlah event yang cocok, tepat hingga 100 dan dibatasi pada 100 di atasnya. Jangan menghitung jumlah halaman dari nilai ini; ikuti next hingga bernilai null.

string<uri> | null

wajib

URL halaman berikutnya, atau null pada halaman terakhir.

string<uri> | null

wajib

URL halaman sebelumnya, atau null pada halaman pertama.

results

object[]

wajib

Show child attributes

Terakhir diubah pada 7 November 2026