Dapatkan Event Pemantauan API

curl

curl -X GET 'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/' \
  -H 'x-api-key: YOUR_API_KEY'

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

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

const result = await didit.monitoringEvents.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);

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

result, err := client.MonitoringEvents.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->monitoringEvents->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());

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

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

var result = await client.MonitoringEvents.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "event_uuid": "33333333-4444-5555-6666-777777777777",
  "event_id": "login-2026-10-17-000001",
  "event_category": "auth",
  "action_type": "login",
  "occurred_at": "2026-10-17T09:15:02.481000Z",
  "received_at": "2026-10-17T09:15:02.903114Z",
  "status": "IN_REVIEW",
  "score": 40,
  "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": "risk_relevant",
  "rules_matched_count": 1,
  "correlation_pending": false,
  "is_droppable": true,
  "payload": {
    "method": "password"
  },
  "custom_values": {
    "vip_tier": "gold",
    "vpn_or_proxy_detected": true
  },
  "device_context": {
    "fingerprint": "fp-a8c1",
    "network_context": {
      "ip_address": "203.0.113.42",
      "ip_country": "Spain",
      "ip_country_code": "ES",
      "ip_city": "Madrid",
      "asn_number": 64500,
      "asn_organization": "Example Networks",
      "is_vpn_or_tor": true,
      "is_data_center": false
    }
  },
  "field_sources": {
    "subject.vendor_data": "customer",
    "event_category": "customer",
    "action_type": "customer",
    "occurred_at": "customer",
    "received_at": "server",
    "payload.method": "customer",
    "session.session_id": "customer",
    "session.sequence": "customer",
    "device_context.fingerprint": "customer",
    "device_context.network_context.ip_address": "customer",
    "device_context.network_context.ip_country": "server",
    "device_context.network_context.ip_country_code": "server",
    "device_context.network_context.ip_city": "server",
    "device_context.network_context.asn_number": "server",
    "device_context.network_context.asn_organization": "server",
    "device_context.network_context.is_vpn_or_tor": "server",
    "device_context.network_context.is_data_center": "server"
  },
  "session_sequence": 142,
  "table_id": null,
  "hand_id": null,
  "match_id": null,
  "market_id": null,
  "side": null,
  "role": null,
  "net_result_amount": null,
  "payment_fingerprint": null,
  "instrument_reference_hash": null,
  "withdrawal_address_hash": null,
  "dispute_id": null,
  "chargeback_id": null,
  "changed_field": null,
  "identity_match_ref": null,
  "schema_version": 1,
  "expires_at": "2027-01-15T09:15:02.481000Z",
  "rules_evaluated_count": 6,
  "rule_runs": [
    {
      "rule_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "rule_title": "Login from VPN or Tor",
      "library_key": null,
      "matched": true,
      "mode": "ACTIVE",
      "is_async": false,
      "severity": "MEDIUM",
      "score_delta": 40,
      "action_summary": "score +40; add_tag:VPN_LOGIN",
      "matched_payload": [
        {
          "field": "event.ip.is_vpn_or_tor",
          "operator": "eq",
          "expected_value": true,
          "current_value": true,
          "matched": true,
          "group_index": null,
          "group_logic": "AND",
          "field_source": "server"
        }
      ],
      "created_at": "2026-10-17T09:15:02.951207Z"
    }
  ],
  "ip_enrichment": {
    "ip_country_code": "ES",
    "ip_city": "Madrid",
    "asn_number": 64500,
    "asn_organization": "Example Networks",
    "is_vpn_or_tor": true,
    "is_data_center": false,
    "proxy_type": null,
    "last_enriched_at": "2026-10-17T09:15:02.910442Z"
  },
  "subject_profile": null,
  "tags": [
    "VPN_LOGIN"
  ]
}

GET

events

{event_uuid}

curl

curl -X GET 'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/' \
  -H 'x-api-key: YOUR_API_KEY'

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

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

const result = await didit.monitoringEvents.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);

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

result, err := client.MonitoringEvents.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->monitoringEvents->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());

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

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

var result = await client.MonitoringEvents.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "event_uuid": "33333333-4444-5555-6666-777777777777",
  "event_id": "login-2026-10-17-000001",
  "event_category": "auth",
  "action_type": "login",
  "occurred_at": "2026-10-17T09:15:02.481000Z",
  "received_at": "2026-10-17T09:15:02.903114Z",
  "status": "IN_REVIEW",
  "score": 40,
  "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": "risk_relevant",
  "rules_matched_count": 1,
  "correlation_pending": false,
  "is_droppable": true,
  "payload": {
    "method": "password"
  },
  "custom_values": {
    "vip_tier": "gold",
    "vpn_or_proxy_detected": true
  },
  "device_context": {
    "fingerprint": "fp-a8c1",
    "network_context": {
      "ip_address": "203.0.113.42",
      "ip_country": "Spain",
      "ip_country_code": "ES",
      "ip_city": "Madrid",
      "asn_number": 64500,
      "asn_organization": "Example Networks",
      "is_vpn_or_tor": true,
      "is_data_center": false
    }
  },
  "field_sources": {
    "subject.vendor_data": "customer",
    "event_category": "customer",
    "action_type": "customer",
    "occurred_at": "customer",
    "received_at": "server",
    "payload.method": "customer",
    "session.session_id": "customer",
    "session.sequence": "customer",
    "device_context.fingerprint": "customer",
    "device_context.network_context.ip_address": "customer",
    "device_context.network_context.ip_country": "server",
    "device_context.network_context.ip_country_code": "server",
    "device_context.network_context.ip_city": "server",
    "device_context.network_context.asn_number": "server",
    "device_context.network_context.asn_organization": "server",
    "device_context.network_context.is_vpn_or_tor": "server",
    "device_context.network_context.is_data_center": "server"
  },
  "session_sequence": 142,
  "table_id": null,
  "hand_id": null,
  "match_id": null,
  "market_id": null,
  "side": null,
  "role": null,
  "net_result_amount": null,
  "payment_fingerprint": null,
  "instrument_reference_hash": null,
  "withdrawal_address_hash": null,
  "dispute_id": null,
  "chargeback_id": null,
  "changed_field": null,
  "identity_match_ref": null,
  "schema_version": 1,
  "expires_at": "2027-01-15T09:15:02.481000Z",
  "rules_evaluated_count": 6,
  "rule_runs": [
    {
      "rule_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "rule_title": "Login from VPN or Tor",
      "library_key": null,
      "matched": true,
      "mode": "ACTIVE",
      "is_async": false,
      "severity": "MEDIUM",
      "score_delta": 40,
      "action_summary": "score +40; add_tag:VPN_LOGIN",
      "matched_payload": [
        {
          "field": "event.ip.is_vpn_or_tor",
          "operator": "eq",
          "expected_value": true,
          "current_value": true,
          "matched": true,
          "group_index": null,
          "group_logic": "AND",
          "field_source": "server"
        }
      ],
      "created_at": "2026-10-17T09:15:02.951207Z"
    }
  ],
  "ip_enrichment": {
    "ip_country_code": "ES",
    "ip_city": "Madrid",
    "asn_number": 64500,
    "asn_organization": "Example Networks",
    "is_vpn_or_tor": true,
    "is_data_center": false,
    "proxy_type": null,
    "last_enriched_at": "2026-10-17T09:15:02.910442Z"
  },
  "subject_profile": null,
  "tags": [
    "VPN_LOGIN"
  ]
}

Lihat Bukti untuk mengetahui cara setiap eksekusi aturan mencatat nilai yang cocok beserta sumbernya, dan Pengayaan IP untuk kolom alamat yang telah diperkaya.

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

event_uuid

string<uuid>

wajib

Pengidentifikasi Didit untuk event tersebut (event_uuid dari respons pembuatan, batch, daftar, atau linimasa), bukan event_id Anda sendiri.

Respons

Event beserta buktinya.

Satu event pemantauan dengan envelope lengkap, pengayaan, dan bukti aturan. Setiap kolom dari MonitoringEvent ditambah kolom-kolom di bawah ini.

event_uuid

string<uuid>

wajib

Pengidentifikasi Didit untuk event tersebut. Gunakan sebagai {event_uuid} dalam panggilan pengambilan dan penghapusan.

event_id

string

wajib

Pengenal Anda sendiri, kunci idempotensi yang Anda kirimkan.

Maximum string length: 128

event_category

enum<string>

wajib

Kategori peristiwa.

Opsi yang tersedia:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string

wajib

Hal yang terjadi dalam kategori, sesuai yang Anda kirimkan.

Maximum string length: 128

occurred_at

string<date-time>

wajib

Waktu ketika peristiwa terjadi di pihak Anda.

received_at

string<date-time>

wajib

Waktu ketika Didit menerima event tersebut.

status

enum<string>

wajib

ACCEPTED: disimpan, tidak ada aturan yang cocok yang mengubah statusnya (jawaban normal untuk sebagian besar peristiwa, dan selalu menjadi jawaban dalam aplikasi sandbox, tempat aturan tidak dijalankan). APPROVED: aturan cocok dan skor tetap di bawah ambang batas peninjauan Anda. IN_REVIEW: aturan menaikkan skor melampaui ambang batas peninjauan atau menetapkan status tersebut. DECLINED: aturan menolaknya atau skor melampaui ambang batas penolakan Anda.

Opsi yang tersedia:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

score

integer

wajib

Skor aturan yang terakumulasi. Dimulai dari 0; tindakan aturan add_score mengubahnya (selisih negatif diizinkan).

subject_vendor_data

string

wajib

subject.vendor_data dari event: id Anda untuk pengguna atau perusahaan.

Maximum string length: 255

subject_entity_type

string

wajib

individual atau company: jenis subjek yang disebut oleh subject_vendor_data.

Contoh:

"individual"

subject_uuid

string<uuid> | null

wajib

UUID pengguna (individu) atau perusahaan yang menjadi hasil resolusi peristiwa, atau null jika rekaman tersebut sudah tidak ada.

counterparty_vendor_data

string | null

wajib

Pihak lain dalam peristiwa P2P (dipromosikan dari payload.counterparty_vendor_data).

Maximum string length: 255

session_id

string | null

wajib

session.session_id dikirim bersama event.

Maximum string length: 255

device_fingerprint

string | null

wajib

device_context.fingerprint dikirim bersama peristiwa.

Maximum string length: 255

ip_address

string | null

wajib

Alamat IP peristiwa. Pada jalur server ini adalah device_context.network_context.ip_address seperti yang Anda kirimkan; pada jalur perangkat ini adalah IP permintaan.

Maximum string length: 64

ip_country

string | null

wajib

Kode negara dari ip_address hasil pengayaan IP, atau null jika alamat tidak diperkaya (hilang, privat, atau telemetri bernilai rendah yang alamatnya belum diketahui).

Contoh:

"ES"

amount

string | null

wajib

Jumlah sebagai string desimal dengan 18 tempat desimal, dari transaction_context.amount, payload.amount atau payload.stake_amount, sesuai urutan tersebut.

Contoh:

"250.000000000000000000"

currency

string | null

wajib

Mata uang dari transaction_context.currency atau payload.currency.

Maximum string length: 10

game_id

string | null

wajib

Dipromosikan dari payload.game_id.

Maximum string length: 128

round_id

string | null

wajib

Dipromosikan dari payload.round_id.

Maximum string length: 128

bonus_id

string | null

wajib

Dipromosikan dari payload.bonus_id.

Maximum string length: 128

affiliate_code

string | null

wajib

Dipromosikan dari payload.affiliate_code.

Maximum string length: 128

payment_reference_id

string | null

wajib

Referensi pembayaran dari transaction_context.payment_reference_id atau payload.payment_reference_id.

Maximum string length: 255

retention_class

enum<string>

wajib

Kelas retensi. Event pembayaran dan sengketa adalah monetary_or_compliance; event keamanan dan perjudian yang bertanggung jawab adalah risk_relevant; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed dan affiliate.referral_clicked adalah low_value; selebihnya adalah standard. Event yang cocok dengan aturan aktif dipromosikan ke risk_relevant (tidak pernah diturunkan).

Opsi yang tersedia:

low_value,

standard,

risk_relevant,

monetary_or_compliance

rules_matched_count

integer

wajib

Jumlah aturan yang cocok dengan peristiwa, termasuk aturan dalam mode TEST (yang mencatat bukti tetapi tidak menerapkan tindakan apa pun).

Rentang yang diperlukan: x >= 0

correlation_pending

boolean

wajib

true selama aturan asinkron (korelasi lintas subjek, atau urutan lebih dari 24 jam) masih harus berjalan untuk event ini. Ini akan terselesaikan dalam beberapa menit dan status, score, serta rules_matched_count akan diperbarui langsung di tempat.

is_droppable

boolean

wajib

Menentukan apakah SDK yang mengalami backpressure boleh mengabaikan event jenis ini. Bernilai false untuk setiap event security, payment, dispute, dan responsible_gambling, serta untuk gameplay.bet_placed, gameplay.bet_settled, dan gameplay.p2p_settlement.

payload

object

wajib

Kolom kategori yang Anda kirimkan dalam payload.

custom_values

object

wajib

Nilai skalar custom_values yang Anda kirim. Didit menambahkan vpn_or_proxy_detected: true atau is_data_center: true saat pengayaan IP menandai alamat tersebut dan Anda tidak mengaturnya.

device_context

object

wajib

Konteks perangkat sebagaimana disimpan: device_context Anda (termasuk fingerprint, persistent_device_id, dan bot_score saat dikirim) dengan network_context yang dilengkapi oleh pengayaan IP (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) untuk kunci yang Anda biarkan kosong.

field_sources

object

wajib

Jalur kolom ke asal-usul (provenance): customer (dikirim oleh backend Anda), sdk (dikirim melalui jalur perangkat), atau server (diturunkan oleh Didit, seperti received_at dan kolom jaringan yang diperkaya). Periksa ini sebelum menindaklanjuti kecocokan.

Show child attributes

session_sequence

integer<int64> | null

wajib

session.sequence dikirim bersama event.

table_id

string | null

wajib

Dipromosikan dari payload.table_id.

Maximum string length: 128

hand_id

string | null

wajib

Dipromosikan dari payload.hand_id.

Maximum string length: 128

match_id

string | null

wajib

Dipromosikan dari payload.match_id.

Maximum string length: 128

market_id

string | null

wajib

Dipromosikan dari payload.market_id.

Maximum string length: 128

side

string | null

wajib

Dipromosikan dari payload.side.

Maximum string length: 64

role

string | null

wajib

Dipromosikan dari payload.role.

Maximum string length: 64

net_result_amount

string | null

wajib

Dipromosikan dari payload.net_result_amount, sebagai string desimal dengan 18 tempat desimal.

Contoh:

"-120.000000000000000000"

payment_fingerprint

string | null

wajib

Dipromosikan dari payload.payment_fingerprint.

Maximum string length: 255

instrument_reference_hash

string | null

wajib

Dipromosikan dari payload.instrument_reference_hash.

Maximum string length: 255

withdrawal_address_hash

string | null

wajib

Dipromosikan dari payload.withdrawal_address_hash (atau payload.destination_reference_hash).

Maximum string length: 255

dispute_id

string | null

wajib

Dipromosikan dari payload.dispute_id.

Maximum string length: 255

chargeback_id

string | null

wajib

Dipromosikan dari payload.chargeback_id.

Maximum string length: 255

changed_field

string | null

wajib

Dipromosikan dari payload.changed_field (peristiwa perubahan keamanan).

Maximum string length: 128

identity_match_ref

string | null

wajib

Dipromosikan dari payload.identity_match_ref (kecocokan dengan registri perjudian yang bertanggung jawab).

Maximum string length: 255

schema_version

integer

wajib

Versi skema envelope event. Saat ini 1.

Contoh:

1

expires_at

string<date-time> | null

wajib

Waktu ketika peristiwa kedaluwarsa berdasarkan kelas retensinya dan dihapus: occurred_at ditambah periode kelas (secara default 14, 30, atau 90 hari, dapat disesuaikan per aplikasi). Null untuk peristiwa monetary_or_compliance, yang mengikuti retensi transaksi.

rules_evaluated_count

integer

wajib

Jumlah aturan event yang dievaluasi untuk event ini.

Rentang yang diperlukan: x >= 0

rule_runs

object[]

wajib

Setiap aturan yang cocok dengan event, yang terbaru terlebih dahulu.

Show child attributes

ip_enrichment

object | null

wajib

Pengayaan alamat IP event, atau null jika alamat tidak diperkaya. Lihat Pengayaan IP.

Show child attributes

subject_profile

object | null

wajib

Sinyal risiko email dan telepon yang di-cache dari subjek, atau null jika tidak ada profil untuk subjek tersebut.

Show child attributes