API Récupérer un événement de surveillance

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

Consultez Preuves pour savoir comment les exécutions de règles enregistrent chaque valeur correspondante et sa source, et Enrichissement IP pour les champs d’adresse enrichis.

Autorisations

x-api-key

string

header

requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

event_uuid

string<uuid>

requis

Identifiant Didit de l'événement (event_uuid issu de la réponse de création, de lot, de liste ou de chronologie), et non votre propre event_id.

Réponse

L'événement avec ses éléments de preuve.

Un événement de surveillance avec son enveloppe complète, son enrichissement et les éléments de preuve des règles. Chaque champ de MonitoringEvent ainsi que les champs ci-dessous.

event_uuid

string<uuid>

requis

Identifiant Didit de l'événement. Utilisez-le comme {event_uuid} dans les appels de récupération et de suppression.

event_id

string

requis

Votre propre identifiant, la clé d'idempotence que vous avez envoyée.

Maximum string length: 128

event_category

enum<string>

requis

Catégorie d'événement.

Options disponibles:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string

requis

Ce qui s'est passé au sein de la catégorie, tel que vous l'avez envoyé.

Maximum string length: 128

occurred_at

string<date-time>

requis

Date et heure de l'événement de votre côté.

received_at

string<date-time>

requis

Date et heure auxquelles Didit a accepté l'événement.

status

enum<string>

requis

ACCEPTED : enregistré, aucune règle correspondante n'a modifié son statut (la réponse normale pour la plupart des événements, et systématiquement la réponse dans une application sandbox, où aucune règle n'est exécutée). APPROVED : une règle s'est appliquée et le score est resté sous votre seuil d'examen. IN_REVIEW : une règle a fait dépasser le seuil d'examen au score ou a défini le statut. DECLINED : une règle l'a refusé ou le score a dépassé votre seuil de refus.

Options disponibles:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

score

integer

requis

Score de règle cumulé. Commence à 0 ; les actions de règle add_score le modifient (les deltas négatifs sont autorisés).

subject_vendor_data

string

requis

subject.vendor_data de l'événement : votre identifiant pour l'utilisateur ou l'entreprise.

Maximum string length: 255

subject_entity_type

string

requis

individual ou company : le type de sujet désigné par subject_vendor_data.

Exemple:

"individual"

subject_uuid

string<uuid> | null

requis

UUID de l'utilisateur (particulier) ou de l'entreprise auquel l'événement a été rattaché, ou null lorsque cet enregistrement n'existe plus.

counterparty_vendor_data

string | null

requis

L'autre acteur d'un événement P2P (promu depuis payload.counterparty_vendor_data).

Maximum string length: 255

session_id

string | null

requis

session.session_id envoyé avec l'événement.

Maximum string length: 255

device_fingerprint

string | null

requis

device_context.fingerprint envoyé avec l'événement.

Maximum string length: 255

ip_address

string | null

requis

Adresse de l'événement. Sur le canal serveur, il s'agit de device_context.network_context.ip_address tel que vous l'avez envoyé ; sur le canal appareil, il s'agit de l'IP de la requête.

Maximum string length: 64

ip_country

string | null

requis

Code pays de ip_address issu de l'enrichissement IP, ou null lorsque l'adresse n'a pas été enrichie (manquante, privée ou télémétrie de faible valeur dont l'adresse n'était pas déjà connue).

Exemple:

"ES"

amount

string | null

requis

Montant sous forme de chaîne décimale avec 18 décimales, provenant de transaction_context.amount, payload.amount ou payload.stake_amount, dans cet ordre.

Exemple:

"250.000000000000000000"

currency

string | null

requis

Devise issue de transaction_context.currency ou payload.currency.

Maximum string length: 10

game_id

string | null

requis

Promu depuis payload.game_id.

Maximum string length: 128

round_id

string | null

requis

Promu depuis payload.round_id.

Maximum string length: 128

bonus_id

string | null

requis

Promu depuis payload.bonus_id.

Maximum string length: 128

affiliate_code

string | null

requis

Promu depuis payload.affiliate_code.

Maximum string length: 128

payment_reference_id

string | null

requis

Référence de paiement issue de transaction_context.payment_reference_id ou de payload.payment_reference_id.

Maximum string length: 255

retention_class

enum<string>

requis

Classe de conservation. Les événements de paiement et de litige sont monetary_or_compliance ; les événements de sécurité et de jeu responsable sont risk_relevant ; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed et affiliate.referral_clicked sont low_value ; tout le reste est standard. Un événement auquel correspond une règle active est promu en risk_relevant (jamais rétrogradé).

Options disponibles:

low_value,

standard,

risk_relevant,

monetary_or_compliance

rules_matched_count

integer

requis

Nombre de règles correspondant à l'événement, y compris les règles en mode TEST (qui enregistrent des éléments probants sans appliquer d'actions).

Plage requise: x >= 0

correlation_pending

boolean

requis

true tant qu'une règle asynchrone (corrélation entre sujets ou séquence de plus de 24 heures) doit encore s'exécuter pour cet événement. Elle se résout en quelques minutes et status, score ainsi que rules_matched_count se mettent à jour sur place.

is_droppable

boolean

requis

Indique si un SDK soumis à une contre-pression peut abandonner les événements de ce type. false pour chaque événement security, payment, dispute et responsible_gambling, ainsi que pour gameplay.bet_placed, gameplay.bet_settled et gameplay.p2p_settlement.

payload

object

requis

Les champs de catégorie que vous avez envoyés dans payload.

custom_values

object

requis

Les custom_values scalaires que vous avez envoyées. Didit ajoute vpn_or_proxy_detected: true ou is_data_center: true lorsque l'enrichissement IP signale l'adresse et que vous ne les avez pas définies.

device_context

object

requis

Le contexte de l'appareil tel qu'il est stocké : votre device_context (incluant fingerprint, persistent_device_id et bot_score lorsqu'ils sont envoyés) avec network_context complété par l'enrichissement IP (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) pour les clés laissées vides.

field_sources

object

requis

Chemin du champ vers sa provenance : customer (envoyé par votre backend), sdk (envoyé via le canal de l'appareil) ou server (dérivé par Didit, comme received_at et les champs réseau enrichis). Vérifiez-le avant d'agir sur une correspondance.

Show child attributes

session_sequence

integer<int64> | null

requis

session.sequence envoyé avec l'événement.

table_id

string | null

requis

Promu depuis payload.table_id.

Maximum string length: 128

hand_id

string | null

requis

Promu depuis payload.hand_id.

Maximum string length: 128

match_id

string | null

requis

Promu depuis payload.match_id.

Maximum string length: 128

market_id

string | null

requis

Promu depuis payload.market_id.

Maximum string length: 128

side

string | null

requis

Promu depuis payload.side.

Maximum string length: 64

role

string | null

requis

Promu depuis payload.role.

Maximum string length: 64

net_result_amount

string | null

requis

Promu depuis payload.net_result_amount, sous forme de chaîne décimale avec 18 décimales.

Exemple:

"-120.000000000000000000"

payment_fingerprint

string | null

requis

Promu depuis payload.payment_fingerprint.

Maximum string length: 255

instrument_reference_hash

string | null

requis

Promu depuis payload.instrument_reference_hash.

Maximum string length: 255

withdrawal_address_hash

string | null

requis

Promu depuis payload.withdrawal_address_hash (ou payload.destination_reference_hash).

Maximum string length: 255

dispute_id

string | null

requis

Promu depuis payload.dispute_id.

Maximum string length: 255

chargeback_id

string | null

requis

Promu depuis payload.chargeback_id.

Maximum string length: 255

changed_field

string | null

requis

Promu depuis payload.changed_field (événements de changement de sécurité).

Maximum string length: 128

identity_match_ref

string | null

requis

Promu depuis payload.identity_match_ref (correspondances au registre du jeu responsable).

Maximum string length: 255

schema_version

integer

requis

Version du schéma de l'enveloppe d'événement. Actuellement 1.

Exemple:

1

expires_at

string<date-time> | null

requis

Date et heure auxquelles l'événement expire selon sa classe de conservation et est supprimé : occurred_at plus la période de la classe (14, 30 ou 90 jours par défaut, ajustable par application). Null pour les événements monetary_or_compliance, qui suivent la conservation des transactions.

rules_evaluated_count

integer

requis

Nombre de règles d'événement évaluées pour cet événement.

Plage requise: x >= 0

rule_runs

object[]

requis

Chaque règle qui correspondait à l'événement, de la plus récente à la plus ancienne.

Show child attributes

ip_enrichment

object | null

requis

Enrichissement de l'adresse IP de l'événement, ou null lorsque l'adresse n'a pas été enrichie. Voir Enrichissement IP.

Show child attributes

subject_profile

object | null

requis

Signaux de risque d'e-mail et de téléphone en cache pour le sujet, ou null lorsqu'aucun profil n'existe pour le sujet.

Show child attributes