> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Таймлайн событий субъекта API > Список всех событий мониторинга одного пользователя или компании от новых к старым в Didit; физлица и компании с одним vendor_data разделяются. Промпт API «Получить хронологию событий субъекта» Скопировать промпт в буфер обмена 
  \`Read the monitoring event timeline of one user or company in my Didit application.

  Endpoint:
  GET [https://verification.didit.me/v3/events/subjects/\{vendor\_data}/](https://verification.didit.me/v3/events/subjects/\{vendor_data}/)

  Authentication:
  Use the x-api-key header with my Didit API key. A scoped key needs transactions: read.

  Goal:

  * Show one subject's activity (logins, sessions, gameplay, bonuses, payments, disputes, security changes) on a customer profile or in an investigation.

  Behavior:

  * vendor\_data is my own id for the subject (subject.vendor\_data of its events). URL-encode it; it cannot contain a slash.
  * vendor\_data is unique only within an entity type: the same id can name an individual and a company, and they are two subjects with two timelines.
  * entity\_type selects the subject: individual (default) or company. Without entity\_type=company, a company id returns the individual's timeline, not both. subject\_entity\_type is accepted as an alias.
  * Newest occurred\_at first, paginated with limit (default 50) and offset. count is capped at 100, so follow next until it is null.
  * The list filters of GET /v3/events/ apply on top: event\_category, action\_type, status, retention\_class (repeat for several values), business\_vendor\_data, session\_id, device\_fingerprint, ip\_address, game\_id, round\_id, affiliate\_code, payment\_reference\_id, counterparty\_vendor\_data, matched\_only, occurred\_from, occurred\_to, search. Occurred\_from and occurred\_to (inclusive; ISO 8601 with Z or an offset whose + is sent as %2B, for example 2026-10-17T09:00:00Z, or a date alone, which means 00:00 UTC of that day).
  * A vendor\_data with no events returns an empty page, not 404.

  Example call:
  curl -X GET "[https://verification.didit.me/v3/events/subjects/acct\_9931/?entity\_type=company\&limit=50](https://verification.didit.me/v3/events/subjects/acct_9931/?entity_type=company\&limit=50)" \
  -H "x-api-key: YOUR\_API\_KEY"

  What to read from the response:

  * results\[] - event summaries (event\_uuid, event\_category, action\_type, occurred\_at, status, score, rules\_matched\_count, ip\_country, device\_fingerprint).
  * results\[].subject\_uuid - the user or company the events resolved to.
  * next - URL of the next page, or null.

  Failure modes:

  * 400 - limit or offset larger than 1000000.
  * 401 - the API key has expired.
  * 403 - missing API key (a wrong, revoked or expired key gets 401), a scoped key without transactions: read, or a request from outside the key's IP list.
  * 429 - more than 600 reads per minute for this API key; honor Retry-After.

  Side effects: none. This is a pure read.

  For the full integration shape, see /integration/integration-prompt.\`
Вставьте в См. [Получение событий](https://docs.didit.me/ru/transaction-monitoring/events.md#чтение-событий) в руководстве по приёму событий. Чтобы искать по всем субъектам, используйте [Список событий мониторинга](https://docs.didit.me/ru/management-api/monitoring-events/list.md). ## OpenAPI ````yaml ru/openapi-25.json GET /v3/events/subjects/{vendor_data}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/events/subjects/{vendor_data}/: get: tags: - Monitoring Events summary: Получить таймлайн событий субъекта description: >- Получить список всех событий мониторинга одного субъекта, сначала самые новые по `occurred_at`. Значение `vendor_data` уникально только в пределах типа сущности, поэтому один и тот же id может относиться как к физическому лицу, так и к компании: параметр `entity_type` определяет, какую хронологию событий вы получите, и по умолчанию имеет значение `individual`, поэтому для событий компании требуется `entity_type=company`. Дополнительно применяются фильтры `GET /v3/events/`, а при отсутствии событий для `vendor_data` возвращается пустая страница, а не `404`. Для API-ключа с ограниченными правами требуется разрешение `transactions: read`. См. [Чтение событий](https://docs.didit.me/ru/transaction-monitoring/events#чтение-событий). operationId: get_monitoring_event_subject_timeline parameters: - name: vendor_data in: path required: true description: >- Ваш id для субъекта (`subject.vendor_data` его событий). Закодируйте его в формате URL; значение, содержащее `/`, не может быть адресовано этим endpoint. schema: type: string minLength: 1 maxLength: 255 example: user-42 - name: entity_type in: query required: false description: >- `company` возвращает компанию с этим `vendor_data`; любое другое значение или его отсутствие возвращает физическое лицо. `subject_entity_type` принимается как псевдоним, если `entity_type` отсутствует. schema: type: string enum: - individual - company default: individual example: individual - name: limit in: query required: false description: >- Максимальное количество событий на страницу. По умолчанию 50. Значения выше 1000000 возвращают `400`; нечисловое, нулевое или отрицательное значение заменяется на 50. schema: type: integer default: 50 minimum: 1 maximum: 1000000 example: 50 - name: offset in: query required: false description: >- Количество событий, которые нужно пропустить. По умолчанию: 0. Рекомендуется переходить по URL `next` из ответа. schema: type: integer maximum: 1000000 minimum: 0 default: 0 example: 0 - name: event_category in: query required: false description: >- Только события в этих категориях. Повторите параметр для нескольких значений (`?event_category=payment&event_category=dispute`); возвращается событие, соответствующее любому из них. style: form explode: true schema: type: array items: type: string enum: - auth - session - gameplay - bonus - affiliate - payment - dispute - security - responsible_gambling - custom example: - payment - dispute - name: action_type in: query required: false description: >- Только события с этими типами действий (точное совпадение с учётом регистра). Повторите для нескольких значений. style: form explode: true schema: type: array items: type: string example: - deposit_completed - chargeback_opened - name: status in: query required: false description: Только события с этими статусами. Повторите для нескольких значений. style: form explode: true schema: type: array items: type: string enum: - ACCEPTED - APPROVED - IN_REVIEW - DECLINED example: - IN_REVIEW - DECLINED - name: retention_class in: query required: false description: >- Только события в этих классах хранения. Повторите для нескольких значений. style: form explode: true schema: type: array items: type: string enum: - low_value - standard - risk_relevant - monetary_or_compliance example: - risk_relevant - name: business_vendor_data in: query required: false description: >- Точное совпадение по `business.vendor_data`, переданному вместе с событием. schema: type: string example: merchant-7 - name: session_id in: query required: false description: Точное совпадение по `session.session_id`. schema: type: string example: web-session-abc - name: device_fingerprint in: query required: false description: Точное совпадение по `device_context.fingerprint`. schema: type: string example: fp-a8c1 - name: ip_address in: query required: false description: Точное совпадение по IP-адресу события. schema: type: string example: 203.0.113.42 - name: game_id in: query required: false description: Точное совпадение по продвигаемому `game_id`. schema: type: string example: poker-holdem-01 - name: round_id in: query required: false description: Точное совпадение по продвигаемому `round_id`. schema: type: string example: round-88231 - name: affiliate_code in: query required: false description: Точное совпадение по продвигаемому `affiliate_code`. schema: type: string example: aff-summer - name: payment_reference_id in: query required: false description: >- Точное совпадение по платёжному идентификатору (из `transaction_context.payment_reference_id` или `payload.payment_reference_id`). schema: type: string example: dep_735 - name: counterparty_vendor_data in: query required: false description: Точное совпадение по продвигаемому `counterparty_vendor_data`. schema: type: string example: user-77 - name: matched_only in: query required: false description: >- `true` (также `1` или `yes`, без учёта регистра) возвращает только события, которым соответствует хотя бы одно правило (`rules_matched_count` больше 0). Любое другое значение игнорируется. schema: type: boolean default: false example: true - name: occurred_from in: query required: false description: >- Только события с `occurred_at` в этот момент или позже (включительно). Передайте значение в формате ISO 8601: `2026-10-01T00:00:00Z`, явное смещение с закодированным знаком `+` (`2026-10-01T02:00:00%2B02:00`; незакодированный `+` декодируется как пробел, и значение перестаёт распознаваться) или только дату (`2026-10-01`), что означает 00:00:00 UTC этого дня. Значение без смещения считывается как UTC. Значения в любом другом формате не принимаются. schema: type: string format: date-time example: '2026-10-01T00:00:00Z' - name: occurred_to in: query required: false description: >- Только события с `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. Значения в любом другом формате не принимаются. schema: type: string format: date-time example: '2026-10-17T23:59:59Z' - name: search in: query required: false description: >- Поиск подстроки без учёта регистра по `event_id`, `action_type`, `subject_vendor_data` или `counterparty_vendor_data`. schema: type: string example: chargeback responses: '200': description: Одна страница событий субъекта. content: application/json: schema: $ref: '#/components/schemas/MonitoringEventPage' examples: Individual timeline: value: 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 No events: value: count: 0 next: null previous: null results: [] '400': description: >- `limit` или `offset` превышает 1000000. Тело ответа представляет собой JSON-массив с одним сообщением. Нечисловое или неположительное значение `limit` возвращается к значению по умолчанию 50 вместо ошибки. content: application/json: examples: limit too large: summary: limit превышает 1000000 value: - limit must not exceed 1000000. offset too large: summary: offset превышает 1000000 value: - offset must not exceed 1000000. '401': description: >- Срок действия API-ключа с ограниченной областью действия истёк. Только при истёкшем сроке действия ключа возвращается `401`; при отсутствии ключа или его недействительности возвращается `403`. content: application/json: examples: Expired key: value: detail: This API key has expired. '403': description: >- Отсутствует `x-api-key` (неверный, отозванный или истекший ключ возвращает `401`), ключ с ограниченной областью действия без права `transactions: read`, ключ, ограниченный определёнными сценариями или одобренными сессиями (такой ключ никогда не получает доступ к данным мониторинга транзакций), либо запрос отправлен не из списка разрешённых адресов ключа. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without access: value: detail: This API key has no read access to transactions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. IP not allowed: value: detail: This API key can't be used from this IP address. '429': description: >- Лимит запросов превышен: `GET`-запросы разделяют лимит в 600 запросов в минуту на один API-ключ. Подождите `Retry-After` секунд, затем повторите попытку. headers: Retry-After: description: Количество секунд ожидания перед повторной попыткой. schema: type: integer minimum: 1 example: 30 content: application/json: examples: Throttled: value: detail: >- GET request rate limit exceeded. You can make up to 600 requests per minute. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/events/subjects/user-42/?entity_type=individual&limit=50' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.monitoring_events.retrieve_subject_timeline( "user-42", ): print(item) - lang: javascript label: Node.js source: >- 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); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.MonitoringEvents.RetrieveSubjectTimelineAutoPaging(ctx, \"user-42\", didit.MonitoringEventsRetrieveSubjectTimelineParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.monitoringEvents().retrieveSubjectTimeline("user-42")) { System.out.println(item); } - lang: php label: PHP source: >- monitoringEvents->retrieveSubjectTimeline('user-42') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.monitoring_events.retrieve_subject_timeline("user-42").auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: >- 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)); } components: schemas: MonitoringEventPage: type: object description: Одна страница событий мониторинга, сначала с самым новым `occurred_at`. required: - count - next - previous - results properties: count: type: integer description: >- Количество подходящих событий: точное до 100, с ограничением в 100 при превышении. Не рассчитывайте количество страниц на его основе; переходите по `next`, пока оно не станет null. next: type: string format: uri nullable: true description: URL следующей страницы или null на последней странице. previous: type: string format: uri nullable: true description: URL предыдущей страницы или null на первой странице. results: type: array items: $ref: '#/components/schemas/MonitoringEvent' MonitoringEvent: type: object description: >- Одно сохранённое событие мониторинга, возвращаемое endpoints для получения списка и таймлайна субъекта. Конфиденциальные доказательства (payload, контекст устройства, доказательства правил) возвращаются только с помощью `GET /v3/events/{event_uuid}/`. required: - event_uuid - event_id - event_category - action_type - occurred_at - received_at - status - score - subject_vendor_data - subject_entity_type - subject_uuid - counterparty_vendor_data - session_id - device_fingerprint - ip_address - ip_country - amount - currency - game_id - round_id - bonus_id - affiliate_code - payment_reference_id - retention_class - rules_matched_count - correlation_pending - is_droppable properties: event_uuid: type: string format: uuid description: >- Идентификатор события в Didit. Используйте его в качестве `{event_uuid}` в вызовах получения и удаления. event_id: type: string maxLength: 128 description: Ваш собственный идентификатор, переданный ключ идемпотентности. event_category: type: string enum: - auth - session - gameplay - bonus - affiliate - payment - dispute - security - responsible_gambling - custom description: Категория события. action_type: type: string maxLength: 128 description: >- Что произошло внутри категории в том виде, в котором вы это отправили. occurred_at: type: string format: date-time description: Когда событие произошло на вашей стороне. received_at: type: string format: date-time description: Когда Didit принял событие. status: type: string enum: - ACCEPTED - APPROVED - IN_REVIEW - DECLINED description: >- `ACCEPTED`: сохранено, ни одно сработавшее правило не изменило статус (стандартный ответ для большинства событий и всегда ответ в приложении в песочнице, где правила не выполняются). `APPROVED`: правило сработало, и оценка осталась ниже вашего порога проверки. `IN_REVIEW`: правило повысило оценку выше порога проверки или установило этот статус. `DECLINED`: правило отклонило запрос или оценка превысила ваш порог отклонения. score: type: integer description: >- Накопленная оценка правила. Начинается с 0; действия правила `add_score` изменяют её (допускаются отрицательные значения дельты). subject_vendor_data: type: string maxLength: 255 description: >- `subject.vendor_data` события: ваш идентификатор пользователя или компании. subject_entity_type: type: string description: >- `individual` или `company`: к какому типу субъекта относится `subject_vendor_data`. example: individual subject_uuid: type: string format: uuid nullable: true description: >- UUID пользователя (физического лица) или компании, к которым относится событие, либо null, если эта запись больше не существует. counterparty_vendor_data: type: string nullable: true description: >- Второй участник P2P-события (перенесено из `payload.counterparty_vendor_data`). maxLength: 255 session_id: type: string nullable: true description: '`session.session_id`, переданный с событием.' maxLength: 255 device_fingerprint: type: string nullable: true description: '`device_context.fingerprint`, отправленный с событием.' maxLength: 255 ip_address: type: string nullable: true description: >- IP-адрес события. В серверном канале это переданный вами `device_context.network_context.ip_address`; в клиентском канале устройства это IP-адрес запроса. maxLength: 64 ip_country: type: string nullable: true description: >- Код страны `ip_address`, полученный в результате обогащения данных IP, или null, если адрес не был обогащён (отсутствует, приватный или малозначимые данные телеметрии, адрес которых ранее не был известен). example: ES amount: type: string nullable: true description: >- Сумма в виде десятичной строки с 18 знаками после запятой, из `transaction_context.amount`, `payload.amount` или `payload.stake_amount`, в указанном порядке. example: '250.000000000000000000' currency: type: string nullable: true description: Валюта из `transaction_context.currency` или `payload.currency`. maxLength: 10 game_id: type: string nullable: true description: Перенесено из `payload.game_id`. maxLength: 128 round_id: type: string nullable: true description: Перенесено из `payload.round_id`. maxLength: 128 bonus_id: type: string nullable: true description: Перенесено из `payload.bonus_id`. maxLength: 128 affiliate_code: type: string nullable: true description: Перенесено из `payload.affiliate_code`. maxLength: 128 payment_reference_id: type: string nullable: true description: >- Идентификатор платежа из `transaction_context.payment_reference_id` или `payload.payment_reference_id`. maxLength: 255 retention_class: type: string enum: - low_value - standard - risk_relevant - monetary_or_compliance description: >- Класс хранения. События платежей и споров имеют класс `monetary_or_compliance`; события безопасности и ответственной игры имеют класс `risk_relevant`; `session.page_view`, `session.sdk_heartbeat`, `session.sdk_loaded`, `session.device_seen`, `session.bot_signal_observed`, `bonus.promotion_viewed` и `affiliate.referral_clicked` имеют класс `low_value`; все остальные имеют класс `standard`. Событие, с которым совпало активное правило, повышается до `risk_relevant` (никогда не понижается). rules_matched_count: type: integer minimum: 0 description: >- Количество правил, совпавших с событием, включая правила в режиме `TEST` (которые фиксируют свидетельства, но не применяют действия). correlation_pending: type: boolean description: >- `true`, пока для этого события ещё должно выполниться асинхронное правило (межсубъектная корреляция или последовательность длительностью более 24 часов). Оно завершается в течение нескольких минут, а значения `status`, `score` и `rules_matched_count` обновляются на месте. is_droppable: type: boolean description: >- Может ли SDK при обратном давлении (backpressure) отбрасывать события этого типа. Значение `false` для каждого события `security`, `payment`, `dispute` и `responsible_gambling`, а также для `gameplay.bet_placed`, `gameplay.bet_settled` и `gameplay.p2p_settlement`. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.