Timeline degli eventi del soggetto API

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

Vedi Lettura degli eventi nella guida all’acquisizione degli eventi. Per cercare tra più soggetti, usa Elenco degli eventi di monitoraggio.

Autorizzazioni

x-api-key

string

header

obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

vendor_data

string

obbligatorio

Il tuo ID per il soggetto (subject.vendor_data dei suoi eventi). Codificalo in formato URL; un valore contenente / non può essere indirizzato da questo endpoint.

Required string length: 1 - 255

Parametri della query

entity_type

enum<string>

predefinito:individual

company restituisce l'azienda con questo vendor_data; qualsiasi altro valore, o nessuno, restituisce la persona fisica. subject_entity_type viene accettato come alias quando entity_type è assente.

Opzioni disponibili:

individual,

company

limit

integer

predefinito:50

Numero massimo di eventi per pagina. Il valore predefinito è 50. I valori superiori a 1000000 restituiscono 400; un valore non numerico, pari a zero o negativo viene reimpostato su 50.

Intervallo richiesto: 1 <= x <= 1000000

offset

integer

predefinito:0

Numero di eventi da saltare. Il valore predefinito è 0. È preferibile seguire l'URL next della risposta.

Intervallo richiesto: 0 <= x <= 1000000

event_category

enum<string>[]

Solo gli eventi in queste categorie. Ripeti il parametro per più valori (?event_category=payment&event_category=dispute); viene restituito un evento corrispondente a uno qualsiasi di essi.

Opzioni disponibili:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string[]

Solo gli eventi con questi tipi di azione (esatti, con distinzione tra maiuscole e minuscole). Ripeti per più valori.

status

enum<string>[]

Solo gli eventi con questi stati. Ripeti per più valori.

Opzioni disponibili:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

retention_class

enum<string>[]

Solo gli eventi in queste classi di conservazione. Ripeti per più valori.

Opzioni disponibili:

low_value,

standard,

risk_relevant,

monetary_or_compliance

business_vendor_data

string

Corrispondenza esatta sul business.vendor_data inviato con l'evento.

session_id

string

Corrispondenza esatta su session.session_id.

device_fingerprint

string

Corrispondenza esatta su device_context.fingerprint.

ip_address

string

Corrispondenza esatta sull'indirizzo IP dell'evento.

game_id

string

Corrispondenza esatta su game_id promosso.

round_id

string

Corrispondenza esatta su round_id promosso.

affiliate_code

string

Corrispondenza esatta su affiliate_code promosso.

payment_reference_id

string

Corrispondenza esatta sul riferimento di pagamento (da transaction_context.payment_reference_id o payload.payment_reference_id).

counterparty_vendor_data

string

Corrispondenza esatta su counterparty_vendor_data promosso.

matched_only

boolean

predefinito:false

true (anche 1 o yes, senza distinzione tra maiuscole e minuscole) restituisce solo gli eventi a cui corrisponde almeno una regola (rules_matched_count maggiore di 0). Qualsiasi altro valore viene ignorato.

occurred_from

string<date-time>

Solo gli eventi con occurred_at pari o successivo a questo istante (incluso). Invia un valore ISO 8601: 2026-10-01T00:00:00Z, un offset esplicito con il + codificato in percentuale (2026-10-01T02:00:00%2B02:00; un + non codificato viene decodificato come spazio e il valore non risulta più analizzabile), oppure solo una data (2026-10-01), che indica le 00:00:00 UTC di quel giorno. Un valore privo di offset viene interpretato come UTC. I valori in qualsiasi altro formato non sono accettati.

occurred_to

string<date-time>

Solo gli eventi con occurred_at pari o antecedente a questo istante (incluso). Una data da sola indica l'inizio di quel giorno, quindi occurred_to=2026-10-15 esclude il resto del 15 ottobre; invia 2026-10-15T23:59:59Z per includerlo. Invia un valore ISO 8601: 2026-10-01T00:00:00Z, un offset esplicito con il + codificato in percentuale (2026-10-01T02:00:00%2B02:00; un + non codificato viene decodificato come spazio e il valore non risulta più analizzabile), oppure solo una data (2026-10-01), che indica le 00:00:00 UTC di quel giorno. Un valore privo di offset viene interpretato come UTC. I valori in qualsiasi altro formato non sono accettati.

string

Corrispondenza di sottostringhe senza distinzione tra maiuscole e minuscole su event_id, action_type, subject_vendor_data o counterparty_vendor_data.

Risposta

Una pagina degli eventi del soggetto.

Una pagina di eventi di monitoraggio, con il valore di occurred_at più recente per primo.

count

integer

obbligatorio

Numero di eventi corrispondenti, esatto fino a 100 e con limite massimo di 100 oltre tale soglia. Non calcolare il conteggio delle pagine da questo valore; segui next finché non è null.

string<uri> | null

obbligatorio

URL della pagina successiva, o null nell'ultima pagina.

string<uri> | null

obbligatorio

URL della pagina precedente, o null nella prima pagina.

results

object[]

obbligatorio

Show child attributes

Ultima modifica il 7 novembre 2026