Ereignis-Timeline pro Subjekt: 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
    }
  ]
}

Siehe Ereignisse abrufen im Leitfaden zur Ereignisaufnahme. Um über alle Subjekte hinweg zu suchen, verwenden Sie Überwachungsereignisse auflisten.

Autorisierungen

x-api-key

string

header

erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

vendor_data

string

erforderlich

Ihre ID für das Subjekt (subject.vendor_data seiner Ereignisse). URL-kodieren Sie sie; ein Wert, der / enthält, kann von diesem Endpoint nicht adressiert werden.

Required string length: 1 - 255

Abfrageparameter

entity_type

enum<string>

Standard:individual

company gibt das Unternehmen mit diesen vendor_data zurück; jeder andere Wert oder kein Wert gibt die Einzelperson zurück. subject_entity_type wird als Alias akzeptiert, wenn entity_type fehlt.

Verfügbare Optionen:

individual,

company

limit

integer

Standard:50

Maximale Anzahl an Ereignissen pro Seite. Standardmäßig 50. Werte über 1000000 geben 400 zurück; ein nicht-numerischer, Null- oder negativer Wert fällt auf 50 zurück.

Erforderlicher Bereich: 1 <= x <= 1000000

offset

integer

Standard:0

Anzahl der zu überspringenden Ereignisse. Standardmäßig 0. Bevorzugen Sie das Folgen der next-URL aus der Antwort.

Erforderlicher Bereich: 0 <= x <= 1000000

event_category

enum<string>[]

Nur Ereignisse in diesen Kategorien. Wiederholen Sie den Parameter für mehrere Werte (?event_category=payment&event_category=dispute); ein Ereignis, das auf einen davon zutrifft, wird zurückgegeben.

Verfügbare Optionen:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string[]

Nur Ereignisse mit diesen Aktionstypen (exakt, unter Berücksichtigung der Groß-/Kleinschreibung). Für mehrere Werte wiederholen.

status

enum<string>[]

Nur Ereignisse mit diesen Status. Für mehrere Werte wiederholen.

Verfügbare Optionen:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

retention_class

enum<string>[]

Nur Ereignisse in diesen Aufbewahrungsklassen. Für mehrere Werte wiederholen.

Verfügbare Optionen:

low_value,

standard,

risk_relevant,

monetary_or_compliance

business_vendor_data

string

Exakte Übereinstimmung mit den mit dem Ereignis gesendeten business.vendor_data.

session_id

string

Exakte Übereinstimmung mit session.session_id.

device_fingerprint

string

Exakte Übereinstimmung mit device_context.fingerprint.

ip_address

string

Exakte Übereinstimmung mit der IP-Adresse des Ereignisses.

game_id

string

Exakte Übereinstimmung mit der promoteten game_id.

round_id

string

Exakte Übereinstimmung mit der promoteten round_id.

affiliate_code

string

Exakte Übereinstimmung mit dem promoteten affiliate_code.

payment_reference_id

string

Exakte Übereinstimmung mit der Zahlungsreferenz (aus transaction_context.payment_reference_id oder payload.payment_reference_id).

counterparty_vendor_data

string

Exakte Übereinstimmung mit den promoteten counterparty_vendor_data.

matched_only

boolean

Standard:false

true (auch 1 oder yes, ohne Berücksichtigung der Groß-/Kleinschreibung) gibt nur Ereignisse zurück, bei denen mindestens eine Regel gegriffen hat (rules_matched_count größer als 0). Jeder andere Wert wird ignoriert.

occurred_from

string<date-time>

Nur Ereignisse mit occurred_at an oder nach diesem Zeitpunkt (einschließlich). Senden Sie einen ISO-8601-Wert: 2026-10-01T00:00:00Z, einen expliziten Offset mit prozentkodiertem + (2026-10-01T02:00:00%2B02:00; ein unkodiertes + wird als Leerzeichen dekodiert und der Wert kann nicht mehr geparst werden) oder nur ein Datum (2026-10-01), was 00:00:00 UTC dieses Tages entspricht. Ein Wert ohne Offset wird als UTC interpretiert. Werte in einem anderen Format werden nicht akzeptiert.

occurred_to

string<date-time>

Nur Ereignisse mit occurred_at an oder vor diesem Zeitpunkt (einschließlich). Ein reines Datum bedeutet den Beginn dieses Tages, daher schließt occurred_to=2026-10-15 den Rest des 15. Oktobers aus; senden Sie 2026-10-15T23:59:59Z, um ihn einzuschließen. Senden Sie einen ISO-8601-Wert: 2026-10-01T00:00:00Z, einen expliziten Offset mit prozentkodiertem + (2026-10-01T02:00:00%2B02:00; ein unkodiertes + wird als Leerzeichen dekodiert und der Wert kann nicht mehr geparst werden) oder nur ein Datum (2026-10-01), was 00:00:00 UTC dieses Tages entspricht. Ein Wert ohne Offset wird als UTC interpretiert. Werte in einem anderen Format werden nicht akzeptiert.

string

Teilstring-Übereinstimmung ohne Berücksichtigung von Groß-/Kleinschreibung auf event_id, action_type, subject_vendor_data oder counterparty_vendor_data.

Antwort

Eine Seite mit den Ereignissen des Subjekts.

Eine Seite mit Überwachungsereignissen, der neueste Wert von occurred_at zuerst.

count

integer

erforderlich

Anzahl der übereinstimmenden Ereignisse, exakt bis 100 und darüber auf 100 begrenzt. Berechnen Sie daraus keine Seitenzahlen; folgen Sie next, bis es null ist.

string<uri> | null

erforderlich

URL der nächsten Seite oder null auf der letzten Seite.

string<uri> | null

erforderlich

URL der vorherigen Seite oder null auf der ersten Seite.

results

object[]

erforderlich

Show child attributes

Zuletzt geändert am 7. November 2026