Monitoring-Event abrufen: Get Monitoring Event 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"
  ]
}

Lesen Sie unter Nachweise, wie Regelausführungen jeden übereinstimmenden Wert und dessen Quelle erfassen, und unter IP-Anreicherung mehr über die angereicherten Adressfelder.

Autorisierungen

x-api-key

string

header

erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

event_uuid

string<uuid>

erforderlich

Didit-Kennung des Ereignisses (event_uuid aus der Create-, Batch-, List- oder Timeline-Antwort), nicht Ihre eigene event_id.

Antwort

Das Ereignis mit seinen Nachweisen.

Ein Überwachungsereignis mit vollständigem Envelope, Anreicherung und Regelnachweisen. Jedes Feld von MonitoringEvent plus die unten stehenden Felder.

event_uuid

string<uuid>

erforderlich

Didit-Kennung des Ereignisses. Verwenden Sie sie als {event_uuid} bei den Abruf- und Löschaufrufen.

event_id

string

erforderlich

Ihre eigene Kennung, der von Ihnen übermittelte Idempotenzschlüssel.

Maximum string length: 128

event_category

enum<string>

erforderlich

Ereigniskategorie.

Verfügbare Optionen:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string

erforderlich

Was innerhalb der Kategorie passiert ist, so wie Sie es gesendet haben.

Maximum string length: 128

occurred_at

string<date-time>

erforderlich

Wann das Ereignis auf Ihrer Seite stattgefunden hat.

received_at

string<date-time>

erforderlich

Wann Didit das Ereignis akzeptiert hat.

status

enum<string>

erforderlich

ACCEPTED: gespeichert, keine zutreffende Regel hat den Status geändert (die normale Antwort für die meisten Ereignisse und immer die Antwort in einer Sandbox-Anwendung, in der keine Regeln ausgeführt werden). APPROVED: eine Regel hat gegriffen und der Score blieb unter Ihrem Prüfungsschwellenwert. IN_REVIEW: eine Regel hat den Score über den Prüfungsschwellenwert verschoben oder den Status gesetzt. DECLINED: eine Regel hat es abgelehnt oder der Score hat Ihren Ablehnungsschwellenwert überschritten.

Verfügbare Optionen:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

score

integer

erforderlich

Akkumulierter Regelwert. Beginnt bei 0; add_score-Regelaktionen verändern ihn (negative Werte sind zulässig).

subject_vendor_data

string

erforderlich

subject.vendor_data des Ereignisses: Ihre ID für den Benutzer oder das Unternehmen.

Maximum string length: 255

subject_entity_type

string

erforderlich

individual oder company: welche Art von Subjekt subject_vendor_data bezeichnet.

Beispiel:

"individual"

subject_uuid

string<uuid> | null

erforderlich

UUID des Benutzers (Einzelperson) oder Unternehmens, zu dem das Ereignis aufgelöst wurde, oder null, wenn dieser Datensatz nicht mehr existiert.

counterparty_vendor_data

string | null

erforderlich

Der andere Beteiligte eines P2P-Ereignisses (hochgestuft aus payload.counterparty_vendor_data).

Maximum string length: 255

session_id

string | null

erforderlich

session.session_id, die mit dem Ereignis gesendet wurde.

Maximum string length: 255

device_fingerprint

string | null

erforderlich

device_context.fingerprint, der mit dem Ereignis gesendet wurde.

Maximum string length: 255

ip_address

string | null

erforderlich

Adresse des Ereignisses. Auf dem Serverpfad ist dies device_context.network_context.ip_address, wie von Ihnen gesendet; auf dem Gerätepfad ist es die IP der Anfrage.

Maximum string length: 64

ip_country

string | null

erforderlich

Ländercode von ip_address aus der IP-Anreicherung oder null, wenn die Adresse nicht angereichert wurde (fehlende, private oder geringwertige Telemetriedaten, deren Adresse noch nicht bekannt war).

Beispiel:

"ES"

amount

string | null

erforderlich

Betrag als Dezimal-String mit 18 Nachkommastellen, aus transaction_context.amount, payload.amount oder payload.stake_amount, in dieser Reihenfolge.

Beispiel:

"250.000000000000000000"

currency

string | null

erforderlich

Währung aus transaction_context.currency oder payload.currency.

Maximum string length: 10

game_id

string | null

erforderlich

Übernommen aus payload.game_id.

Maximum string length: 128

round_id

string | null

erforderlich

Übernommen aus payload.round_id.

Maximum string length: 128

bonus_id

string | null

erforderlich

Aus payload.bonus_id übernommen.

Maximum string length: 128

affiliate_code

string | null

erforderlich

Aus payload.affiliate_code übernommen.

Maximum string length: 128

payment_reference_id

string | null

erforderlich

Zahlungsreferenz aus transaction_context.payment_reference_id oder payload.payment_reference_id.

Maximum string length: 255

retention_class

enum<string>

erforderlich

Aufbewahrungsklasse. Zahlungs- und Streitfall-Ereignisse sind monetary_or_compliance; Sicherheits- und Spielerschutz-Ereignisse sind risk_relevant; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed und affiliate.referral_clicked sind low_value; alles andere ist standard. Ein Ereignis, auf das eine aktive Regel zutrifft, wird auf risk_relevant hochgestuft (niemals herabgestuft).

Verfügbare Optionen:

low_value,

standard,

risk_relevant,

monetary_or_compliance

rules_matched_count

integer

erforderlich

Anzahl der Regeln, die auf das Ereignis zutrafen, einschließlich Regeln im TEST-Modus (die Nachweise aufzeichnen, aber keine Aktionen anwenden).

Erforderlicher Bereich: x >= 0

correlation_pending

boolean

erforderlich

true, solange eine asynchrone Regel (subjektübergreifende Korrelation oder eine Sequenz von mehr als 24 Stunden) für dieses Ereignis noch ausgeführt werden muss. Sie wird innerhalb von Minuten aufgelöst, und status, score sowie rules_matched_count werden direkt aktualisiert.

is_droppable

boolean

erforderlich

Gibt an, ob ein SDK unter Systemüberlastung (Backpressure) Ereignisse dieser Art verwerfen darf. false für jedes security-, payment-, dispute- und responsible_gambling-Ereignis sowie für gameplay.bet_placed, gameplay.bet_settled und gameplay.p2p_settlement.

payload

object

erforderlich

Die Kategoriefelder, die Sie in payload gesendet haben.

custom_values

object

erforderlich

Die von Ihnen gesendeten skalaren custom_values. Didit fügt vpn_or_proxy_detected: true oder is_data_center: true hinzu, wenn die IP-Anreicherung die Adresse markiert und Sie diese nicht festgelegt haben.

device_context

object

erforderlich

Der gespeicherte Gerätekontext: Ihr device_context (einschließlich fingerprint, persistent_device_id und bot_score, falls gesendet) mit network_context, ergänzt durch IP-Anreicherung (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) für Schlüssel, die Sie leer gelassen haben.

field_sources

object

erforderlich

Feldpfad zur Herkunft: customer (von Ihrem Backend gesendet), sdk (über die Gerätespur gesendet) oder server (von Didit abgeleitet, wie z. B. received_at und angereicherte Netzwerkfelder). Prüfen Sie diesen vor Maßnahmen bei einer Übereinstimmung.

Show child attributes

session_sequence

integer<int64> | null

erforderlich

session.sequence, die mit dem Ereignis gesendet wurde.

table_id

string | null

erforderlich

Übernommen aus payload.table_id.

Maximum string length: 128

hand_id

string | null

erforderlich

Übernommen aus payload.hand_id.

Maximum string length: 128

match_id

string | null

erforderlich

Übernommen aus payload.match_id.

Maximum string length: 128

market_id

string | null

erforderlich

Übernommen aus payload.market_id.

Maximum string length: 128

side

string | null

erforderlich

Übernommen aus payload.side.

Maximum string length: 64

role

string | null

erforderlich

Übernommen aus payload.role.

Maximum string length: 64

net_result_amount

string | null

erforderlich

Übernommen aus payload.net_result_amount, als Dezimal-String mit 18 Dezimalstellen.

Beispiel:

"-120.000000000000000000"

payment_fingerprint

string | null

erforderlich

Übernommen aus payload.payment_fingerprint.

Maximum string length: 255

instrument_reference_hash

string | null

erforderlich

Übernommen aus payload.instrument_reference_hash.

Maximum string length: 255

withdrawal_address_hash

string | null

erforderlich

Übernommen aus payload.withdrawal_address_hash (oder payload.destination_reference_hash).

Maximum string length: 255

dispute_id

string | null

erforderlich

Übernommen aus payload.dispute_id.

Maximum string length: 255

chargeback_id

string | null

erforderlich

Übernommen aus payload.chargeback_id.

Maximum string length: 255

changed_field

string | null

erforderlich

Übernommen aus payload.changed_field (Sicherheitsänderungsereignisse).

Maximum string length: 128

identity_match_ref

string | null

erforderlich

Übernommen aus payload.identity_match_ref (Treffer im Register für verantwortungsvolles Spielen).

Maximum string length: 255

schema_version

integer

erforderlich

Version des Ereignis-Envelope-Schemas. Derzeit 1.

Beispiel:

1

expires_at

string<date-time> | null

erforderlich

Wann das Ereignis gemäß seiner Aufbewahrungsklasse abläuft und gelöscht wird: occurred_at zuzüglich der Klassenfrist (standardmäßig 14, 30 oder 90 Tage, anpassbar pro Anwendung). Null für monetary_or_compliance-Ereignisse, die der Transaktionsaufbewahrung folgen.

rules_evaluated_count

integer

erforderlich

Anzahl der für dieses Ereignis ausgewerteten Ereignisregeln.

Erforderlicher Bereich: x >= 0

rule_runs

object[]

erforderlich

Jede Regel, die auf das Ereignis zutraf, die neueste zuerst.

Show child attributes

ip_enrichment

object | null

erforderlich

Anreicherung der Adresse des Ereignisses oder null, wenn die Adresse nicht angereichert wurde. Siehe Anreicherung der Adresse.

Show child attributes

subject_profile

object | null

erforderlich

Gecachte E-Mail- und Telefon-Risikosignale der Person, oder null, wenn kein Profil für die Person existiert.

Show child attributes