Таймлайн событий субъекта 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
    }
  ]
}

См. Получение событий в руководстве по приёму событий. Чтобы искать по всем субъектам, используйте Список событий мониторинга.

Авторизации

x-api-key

string

header

обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

vendor_data

string

обязательно

Ваш id для субъекта (subject.vendor_data его событий). Закодируйте его в формате URL; значение, содержащее /, не может быть адресовано этим endpoint.

Required string length: 1 - 255

Параметры запроса

entity_type

enum<string>

по умолчанию:individual

company возвращает компанию с этим vendor_data; любое другое значение или его отсутствие возвращает физическое лицо. subject_entity_type принимается как псевдоним, если entity_type отсутствует.

Доступные опции:

individual,

company

limit

integer

по умолчанию:50

Максимальное количество событий на страницу. По умолчанию 50. Значения выше 1000000 возвращают 400; нечисловое, нулевое или отрицательное значение заменяется на 50.

Требуемый диапазон: 1 <= x <= 1000000

offset

integer

по умолчанию:0

Количество событий, которые нужно пропустить. По умолчанию: 0. Рекомендуется переходить по URL next из ответа.

Требуемый диапазон: 0 <= x <= 1000000

event_category

enum<string>[]

Только события в этих категориях. Повторите параметр для нескольких значений (?event_category=payment&event_category=dispute); возвращается событие, соответствующее любому из них.

Доступные опции:

auth,

session,

gameplay,

bonus,

affiliate,

payment,

dispute,

security,

responsible_gambling,

custom

action_type

string[]

Только события с этими типами действий (точное совпадение с учётом регистра). Повторите для нескольких значений.

status

enum<string>[]

Только события с этими статусами. Повторите для нескольких значений.

Доступные опции:

ACCEPTED,

APPROVED,

IN_REVIEW,

DECLINED

retention_class

enum<string>[]

Только события в этих классах хранения. Повторите для нескольких значений.

Доступные опции:

low_value,

standard,

risk_relevant,

monetary_or_compliance

business_vendor_data

string

Точное совпадение по business.vendor_data, переданному вместе с событием.

session_id

string

Точное совпадение по session.session_id.

device_fingerprint

string

Точное совпадение по device_context.fingerprint.

ip_address

string

Точное совпадение по IP-адресу события.

game_id

string

Точное совпадение по продвигаемому game_id.

round_id

string

Точное совпадение по продвигаемому round_id.

affiliate_code

string

Точное совпадение по продвигаемому affiliate_code.

payment_reference_id

string

Точное совпадение по платёжному идентификатору (из transaction_context.payment_reference_id или payload.payment_reference_id).

counterparty_vendor_data

string

Точное совпадение по продвигаемому counterparty_vendor_data.

matched_only

boolean

по умолчанию:false

true (также 1 или yes, без учёта регистра) возвращает только события, которым соответствует хотя бы одно правило (rules_matched_count больше 0). Любое другое значение игнорируется.

occurred_from

string<date-time>

Только события с occurred_at в этот момент или позже (включительно). Передайте значение в формате ISO 8601: 2026-10-01T00:00:00Z, явное смещение с закодированным знаком + (2026-10-01T02:00:00%2B02:00; незакодированный + декодируется как пробел, и значение перестаёт распознаваться) или только дату (2026-10-01), что означает 00:00:00 UTC этого дня. Значение без смещения считывается как UTC. Значения в любом другом формате не принимаются.

occurred_to

string<date-time>

Только события с occurred_at в этот момент или раньше (включительно). Дата без времени означает начало этого дня, поэтому occurred_to=2026-10-15 исключает остальную часть 15 октября; отправьте 2026-10-15T23:59:59Z, чтобы включить её. Передайте значение в формате ISO 8601: 2026-10-01T00:00:00Z, явное смещение с закодированным знаком + (2026-10-01T02:00:00%2B02:00; незакодированный + декодируется как пробел, и значение перестаёт распознаваться) или только дату (2026-10-01), что означает 00:00:00 UTC этого дня. Значение без смещения считывается как UTC. Значения в любом другом формате не принимаются.

string

Поиск подстроки без учёта регистра по event_id, action_type, subject_vendor_data или counterparty_vendor_data.

Ответ

Одна страница событий субъекта.

Одна страница событий мониторинга, сначала с самым новым occurred_at.

count

integer

обязательно

Количество подходящих событий: точное до 100, с ограничением в 100 при превышении. Не рассчитывайте количество страниц на его основе; переходите по next, пока оно не станет null.

string<uri> | null

обязательно

URL следующей страницы или null на последней странице.

string<uri> | null

обязательно

URL предыдущей страницы или null на первой странице.

results

object[]

обязательно

Show child attributes

Последнее изменение 7 ноября 2026 г.