Liste des événements de surveillance (API)

curl

curl -X GET 'https://verification.didit.me/v3/events/?event_category=payment&event_category=dispute&matched_only=true&occurred_from=2026-10-01T00:00:00Z&limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

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

iter := client.MonitoringEvents.ListAutoPaging(ctx, didit.MonitoringEventsListParams{})
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->list() 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.ListAsync())
{
    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

curl

curl -X GET 'https://verification.didit.me/v3/events/?event_category=payment&event_category=dispute&matched_only=true&occurred_from=2026-10-01T00:00:00Z&limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

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

iter := client.MonitoringEvents.ListAutoPaging(ctx, didit.MonitoringEventsListParams{})
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->list() 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.ListAsync())
{
    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
    }
  ]
}

Les événements sont classés par classes de conservation, donc un événement dont la période de conservation est arrivée à son terme n’apparaît plus ici. Consultez Ingestion des événements pour la référence des filtres, et Règles sur les événements pour ce qui fait évoluer rules_matched_count.

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 requête

limit

integer

défaut:50

Nombre maximal d'événements par page. Vaut par défaut 50. Les valeurs supérieures à 1000000 renvoient 400 ; une valeur non numérique, nulle ou négative revient à 50.

Plage requise: 1 <= x <= 1000000

offset

integer

défaut:0

Nombre d'événements à ignorer. Vaut 0 par défaut. Privilégiez l'utilisation de l'URL next de la réponse.

Plage requise: 0 <= x <= 1000000

event_category

enum<string>[]

Uniquement les événements appartenant à ces catégories. Répétez le paramètre pour plusieurs valeurs (?event_category=payment&event_category=dispute) ; un événement correspondant à l'une d'entre elles est renvoyé.

Options disponibles:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string[]

Uniquement les événements associés à ces types d'actions (exacts, sensibles à la casse). Répétez pour plusieurs valeurs.

status

enum<string>[]

Uniquement les événements associés à ces statuts. Répétez pour plusieurs valeurs.

Options disponibles:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

retention_class

enum<string>[]

Uniquement les événements appartenant à ces classes de conservation. Répétez pour plusieurs valeurs.

Options disponibles:

low_value,

standard,

risk_relevant,

monetary_or_compliance

subject_vendor_data

string

Correspondance exacte sur le vendor_data du sujet. Le même identifiant peut désigner un individu et une entreprise ; ajoutez subject_entity_type pour en choisir un, ou utilisez GET /v3/events/subjects/{vendor_data}/.

subject_entity_type

enum<string>

company ne renvoie que les événements des sujets correspondant à des entreprises ; toute autre valeur non vide (par exemple individual) ne renvoie que les événements des individus. Omettez-le pour renvoyer les deux.

Options disponibles:

individual,

company

business_vendor_data

string

Correspondance exacte sur le business.vendor_data envoyé avec l'événement.

session_id

string

Correspondance exacte sur session.session_id.

device_fingerprint

string

Correspondance exacte sur device_context.fingerprint.

ip_address

string

Correspondance exacte sur l'adresse IP de l'événement.

game_id

string

Correspondance exacte sur le game_id promu.

round_id

string

Correspondance exacte sur le round_id promu.

affiliate_code

string

Correspondance exacte sur le affiliate_code promu.

payment_reference_id

string

Correspondance exacte sur la référence de paiement (provenant de transaction_context.payment_reference_id ou de payload.payment_reference_id).

counterparty_vendor_data

string

Correspondance exacte sur le counterparty_vendor_data promu.

matched_only

boolean

défaut:false

true (également 1 ou yes, insensible à la casse) renvoie uniquement les événements pour lesquels au moins une règle a correspondu (rules_matched_count supérieur à 0). Toute autre valeur est ignorée.

occurred_from

string<date-time>

Uniquement les événements dont occurred_at est supérieur ou égal à cet instant (inclus). Envoyez une valeur ISO 8601 : 2026-10-01T00:00:00Z, un décalage explicite avec le + encodé en pourcentage (2026-10-01T02:00:00%2B02:00 ; un + non encodé est décodé comme un espace et la valeur ne peut plus être analysée), ou une date seule (2026-10-01), ce qui correspond à 00:00:00 UTC de ce jour-là. Une valeur sans décalage est interprétée en UTC. Les valeurs dans tout autre format ne sont pas acceptées.

occurred_to

string<date-time>

Uniquement les événements dont occurred_at est inférieur ou égal à cet instant (inclus). Une date seule indique le début de cette journée, donc occurred_to=2026-10-15 exclut le reste du 15 octobre ; envoyez 2026-10-15T23:59:59Z pour l'inclure. Envoyez une valeur ISO 8601 : 2026-10-01T00:00:00Z, un décalage explicite avec le + encodé en pourcentage (2026-10-01T02:00:00%2B02:00 ; un + non encodé est décodé comme un espace et la valeur ne peut plus être analysée), ou une date seule (2026-10-01), ce qui correspond à 00:00:00 UTC de ce jour-là. Une valeur sans décalage est interprétée en UTC. Les valeurs dans tout autre format ne sont pas acceptées.

string

Correspondance insensible à la casse sur une sous-chaîne de event_id, action_type, subject_vendor_data ou counterparty_vendor_data.

Réponse

Une page de résumés d'événements.

Une page d'événements de surveillance, avec le occurred_at le plus récent en premier.

count

integer

requis

Nombre d'événements correspondants, exact jusqu'à 100 et plafonné à 100 au-delà. Ne calculez pas le nombre de pages à partir de celui-ci ; suivez next jusqu'à ce qu'il soit null.

string<uri> | null

requis

URL de la page suivante, ou null sur la dernière page.

string<uri> | null

requis

URL de la page précédente, ou null sur la première page.

results

object[]

requis

Show child attributes

Dernière modification le 7 novembre 2026