API de cronologia d'esdeveniments de subjectes

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

Consulta Recuperar esdeveniments a la guia d’ingestió d’esdeveniments. Per cercar entre subjectes, utilitza Llistar esdeveniments de monitoratge.

Autoritzacions

x-api-key

string

header

requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

vendor_data

string

requerit

El teu id per al subjecte (subject.vendor_data dels seus esdeveniments). Codifica'l com a URL; aquest endpoint no pot adreçar un valor que contingui /.

Required string length: 1 - 255

Paràmetres de consulta

entity_type

enum<string>

predeterminat:individual

company retorna l'empresa amb aquest vendor_data; qualsevol altre valor, o cap, retorna l'individu. S'accepta subject_entity_type com a àlies quan entity_type no hi és present.

Opcions disponibles:

individual,

company

limit

integer

predeterminat:50

Nombre màxim d'esdeveniments per pàgina. Per defecte és 50. Els valors superiors a 1000000 retornen 400; un valor no numèric, zero o negatiu torna al valor predeterminat de 50.

Rang requerit: 1 <= x <= 1000000

offset

integer

predeterminat:0

Nombre d'esdeveniments que cal ometre. Per defecte és 0. És preferible seguir l'URL next de la resposta.

Rang requerit: 0 <= x <= 1000000

event_category

enum<string>[]

Només esdeveniments en aquestes categories. Repeteix el paràmetre per a diversos valors (?event_category=payment&event_category=dispute); es retorna un esdeveniment que coincideixi amb qualsevol d'ells.

Opcions disponibles:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string[]

Només esdeveniments amb aquests tipus d'acció (exactes i que distingeixen entre majúscules i minúscules). Repeteix per a diversos valors.

status

enum<string>[]

Només esdeveniments amb aquests estats. Repeteix per a diversos valors.

Opcions disponibles:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

retention_class

enum<string>[]

Només esdeveniments en aquestes classes de conservació. Repeteix per a diversos valors.

Opcions disponibles:

low_value,

standard,

risk_relevant,

monetary_or_compliance

business_vendor_data

string

Coincidència exacta amb el business.vendor_data enviat amb l'esdeveniment.

session_id

string

Coincidència exacta amb session.session_id.

device_fingerprint

string

Coincidència exacta amb device_context.fingerprint.

ip_address

string

Coincidència exacta amb l'adreça IP de l'esdeveniment.

game_id

string

Coincidència exacta amb el game_id promocionat.

round_id

string

Coincidència exacta amb el round_id promocionat.

affiliate_code

string

Coincidència exacta amb l'affiliate_code promocionat.

payment_reference_id

string

Coincidència exacta amb la referència de pagament (de transaction_context.payment_reference_id o payload.payment_reference_id).

counterparty_vendor_data

string

Coincidència exacta amb el counterparty_vendor_data promocionat.

matched_only

boolean

predeterminat:false

true (també 1 o yes, no distingeix majúscules de minúscules) només retorna esdeveniments en què ha coincidit almenys una regla (rules_matched_count superior a 0). Qualsevol altre valor s'ignora.

occurred_from

string<date-time>

Només esdeveniments amb occurred_at en aquest instant o després (inclusiu). Envia un valor ISO 8601: 2026-10-01T00:00:00Z, un desplaçament explícit amb el + codificat en percentatge (2026-10-01T02:00:00%2B02:00; un + sense codificar es descodifica com un espai i el valor deixa de processar-se correctament), o només una data (2026-10-01), que significa les 00:00:00 UTC d'aquell dia. Un valor sense desplaçament s'interpreta com a UTC. No s'accepten valors en cap altre format.

occurred_to

string<date-time>

Només esdeveniments amb occurred_at en aquest instant o abans (inclusiu). Només una data significa l'inici d'aquell dia, de manera que occurred_to=2026-10-15 exclou la resta del 15 d'octubre; envia 2026-10-15T23:59:59Z per incloure-ho. Envia un valor ISO 8601: 2026-10-01T00:00:00Z, un desplaçament explícit amb el + codificat en percentatge (2026-10-01T02:00:00%2B02:00; un + sense codificar es descodifica com un espai i el valor deixa de processar-se correctament), o només una data (2026-10-01), que significa les 00:00:00 UTC d'aquell dia. Un valor sense desplaçament s'interpreta com a UTC. No s'accepten valors en cap altre format.

string

Coincidència de subcadena que no distingeix majúscules de minúscules a event_id, action_type, subject_vendor_data o counterparty_vendor_data.

Resposta

Una pàgina dels esdeveniments del subjecte.

Una pàgina d'esdeveniments de monitoratge, amb el occurred_at més recent primer.

count

integer

requerit

Nombre d'esdeveniments coincidents, exacte fins a 100 i limitat a 100 per sobre d'aquest valor. No calculis el nombre de pàgines a partir d'aquest valor; segueix next fins que sigui nul.

string<uri> | null

requerit

URL de la pàgina següent, o null a l'última pàgina.

string<uri> | null

requerit

URL de la pàgina anterior, o null a la primera pàgina.

results

object[]

requerit

Show child attributes

Darrera modificació el 7 de novembre del 2026