Chronologie des événements par sujet, API Didit

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

Voir Relire les événements dans le guide d’ingestion des événements. Pour rechercher parmi plusieurs sujets, utilisez Lister les événements de surveillance.

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

vendor_data

string

requis

Votre identifiant pour le sujet (subject.vendor_data de ses événements). Encodez-le au format URL ; une valeur contenant / ne peut pas être adressée par cet endpoint.

Required string length: 1 - 255

Paramètres de requête

entity_type

enum<string>

défaut:individual

company renvoie l'entreprise associée à ce vendor_data ; toute autre valeur, ou aucune valeur, renvoie l'individu. subject_entity_type est accepté comme alias lorsque entity_type est absent.

Options disponibles:

individual,

company

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

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 des événements du sujet.

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