> ## 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; при contract=2 — постраничный таймлайн попыток, транзакций, входов, правил и кейсов. Промпт для API хронологии сети Скопировать промпт в буфер обмена \

\`Retrieve a fraud network's event timeline through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/

Authentication:
Use the x-api-key header with my Didit API key.
Networks endpoints need a full-access API key: a key with restricted access gets 403.

Path parameter:
\- network_uuid - the network's UUID.

Two shapes, chosen by the contract query parameter:

1\. Default (no contract parameter): unchanged.
Response 200: {"results": [NetworkTimelineEvent, ...]}, oldest first, not paginated.
Each event has event_type (network_detected, signal_observed, network_active, network_in_review, network_resolved, network_dismissed), occurred_at, label, and metadata (event-specific, e.g. {network_id} for detection, {signal_type, subject_count, is_hub} for a signal observation, {reason} for a status change).
limit, cursor and event_type are ignored in this mode.

2\. Typed timeline (contract=2, opt-in):
Query params:
\- contract=2: required for this mode. Any other value is a 400.
\- limit: 1 to 500, default 100.
\- cursor: the previous page's next_cursor. An invalid or empty cursor is a 400 ("This cursor is not valid. Reload the feed.").
\- event_type: repeat it or pass a comma-separated list, at most 20 values. Defaults to every type: network_detected, signal_observed, network_active, network_in_review, network_resolved, network_dismissed, verification_attempt, transaction, login, rule_hit, case_linked, note_added.
Response 200: {"results": [NetworkTypedTimelineEvent, ...], "next_cursor": string|null}, newest first. Keep calling with cursor=next_cursor until next_cursor is null.
Each typed event has:
\- event_type, occurred_at, label, metadata: as in the default shape (metadata is {} for events that are not the network's own).
\- id: ":", unique within the timeline. ingested_at: when Didit stored it.
\- account: the member account {node_id ("vendor_user:", "vendor_business:" or "transaction_party:"), node_type (account|business_account|transaction_party), uuid, vendor_data, display_name, ownership (owned|organization), route {kind, id, application_id}}. Null for the network's own events, case_linked and note_added.
\- source_ref: the record it was read from {kind (session|business_session|transaction|monitoring_event|case), id, ownership, route}. route is absent for monitoring_event and case. Null for the network's own events and note_added.
\- ownership: owned when the record belongs to the application I called, organization when it belongs to another application of my organization.
\- One detail block per event type, the others null:
\- verification_attempt {session_id, session_number, attempt, attempt_count, status, status_changed_at, decline_reasons [{risk, feature, short_description}] (declined sessions only)}
\- transaction {transaction_id, transaction_number, transaction_type, action_type, amount {value, currency, direction} or null, status, decision_reason_code, decision_reason_label, party_role}
\- login {action (auth.login, security.login_succeeded, auth.login_failed or security.login_failed), succeeded, status, ip {address, country_code, city, connection_type (free text), is_vpn_or_tor, is_data_center} or null, device {fingerprint, label} or null, is_first_login, is_new_device}
\- rule_hit {rule_id, rule_title, rule_category, rule_source, severity, score_delta, status_target, action_summary}
\- case_linked {case_id, case_number, status, author_email, author_name}
\- note_added {note_id, author_email}: never returned to an API key, only to console members.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/?contract=2&limit=50&event_type=verification_attempt,login" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 400 (contract mode only): {"contract": [...]}, {"limit": [...]}, {"cursor": ["This cursor is not valid. Reload the feed."]} or {"event_type": {...}}.
\- 404: {"detail": "Network not found."}. The network does not exist, or has no member visible to this application.
\- 401: missing or invalid x-api-key.
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs read:networks.
\- 403 with {"code": "networks_not_entitled"}: Networks is not enabled for the organization.

Side effects: none, pure read.

For the full integration shape, see /integration/integration-prompt.`

\
Вставьте в Получите историю событий сети. Без `contract` ответ содержит собственную историю сети: от самого раннего события к последнему, без пагинации. В нём указано, когда сеть была впервые обнаружена, когда в последний раз фиксировался каждый сигнал, и её последнее изменение статуса с причиной. Этот формат не изменился, а `limit`, `cursor` и `event_type` игнорируются.## Типизированная хронологияПередайте `contract=2`, чтобы получить типизированную хронологию. Она добавляет действия аккаунтов участников и действия вашей команды в отношении сети, от новых событий к старым, по одной странице за раз. `contract` принимает только `2`; любое другое значение возвращает `400`.| Параметр | Значение | | - | - | | `limit` | Количество событий на странице, от 1 до 500. По умолчанию 100. | | `cursor` | Значение `next_cursor` предыдущей страницы. Недействительный или пустой курсор возвращает `400`. | | `event_type` | Типы событий, которые нужно оставить; можно повторять параметр или перечислить через запятую, не более 20 значений. По умолчанию возвращаются все типы. |Ответ имеет вид `{"results": [...], "next_cursor": "..."}`. Чтобы получить следующую страницу, передайте в `cursor` значение `next_cursor`, пока `next_cursor` не станет `null`.## Типы событий| `event_type` | Что фиксирует | Блок деталей | | - | - | - | | `network_detected` | Сеть обнаружена | Нет | | `signal_observed` | Последнее наблюдение сигнала | Нет | | `network_active`, `network_in_review`, `network_resolved`, `network_dismissed` | Последнее изменение статуса сети с причиной в `metadata` | Нет | | `verification_attempt` | Сессия верификации участника (человека или компании) с номером (`attempt` из `attempt_count`) и причинами отказа, если она отклонена | `verification_attempt` | | `transaction` | Транзакция, в которой участвовал участник, с датой транзакции | `transaction` | | `login` | Вход или неудачная попытка входа, которую вы передали для участника через [API событий](https://docs.didit.me/ru/transaction-monitoring/events.md) | `login` | | `rule_hit` | Активное правило, совпавшее с транзакцией или событием участника | `rule_hit` | | `case_linked` | Кейс, открытый для сети в вашей организации | `case_linked` | | `note_added` | Заметка, оставленная для сети, без её текста | `note_added` |События `note_added` возвращаются только участникам консоли, но никогда не возвращаются API-ключу. Транзакция между двумя участниками появляется по одному разу для каждого из них, и у каждой записи свой `account`. Срабатывание правила на эту транзакцию появляется один раз. События входа существуют только для входов, которые вы передаёте как события: `auth.login`, `security.login_succeeded` и их варианты с неудачной попыткой.## Аккаунты и записиКаждое событие участника содержит `account` (участника, которому оно принадлежит) и `source_ref` (сессию, бизнес-сессию, транзакцию, событие мониторинга или кейс, из которых оно получено). `ownership` имеет значение `owned`, когда запись принадлежит приложению, которое вы вызвали, и `organization`, когда она принадлежит другому приложению вашей организации. `route` содержит тип записи, UUID и приложение; у `source_ref` нет `route` для события мониторинга или кейса. События самой сети не содержат ни `account`, ни `source_ref`.## Связанные материалы- [Получить сеть](https://docs.didit.me/ru/management-api/networks/get.md) - [Сигналы сети](https://docs.didit.me/ru/management-api/networks/signals.md) - [Карта сети](https://docs.didit.me/ru/management-api/networks/map.md) - [Приём событий](https://docs.didit.me/ru/transaction-monitoring/events.md) ## OpenAPI ````yaml ru/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/ 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/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/timeline/: get: tags: - Networks summary: Получить таймлайн сети description: >- Без `contract`: собственные события сети (обнаружение, последнее наблюдение каждого сигнала и его проверка), сначала старые, без пагинации. `limit`, `cursor` и `event_type` игнорируются. С `contract=2`: типизированная временная шкала, сначала новые, с пагинацией по курсору. Добавляет действия аккаунтов-участников (попытки верификации, транзакции, входы в систему, отправленные вами через API событий, и сработавшие активные правила) и кейсы, открытые для сети. События `note_added` возвращаются только участникам консоли и никогда не возвращаются API-ключу. Требуется API-ключ с полным доступом или `read:networks` для участника консоли. operationId: get_network_timeline parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID организации. - name: application_id in: path required: true schema: type: string format: uuid description: UUID приложения. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID сети. - name: contract in: query required: false schema: type: string enum: - '2' description: >- `2` возвращает типизированную хронологию. Опустите его для хронологии по умолчанию. Любое другое значение возвращает 400. - name: limit in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 500 description: >- Только для типизированной ленты событий. Количество событий на странице, от 1 до 500. По умолчанию 100. - name: cursor in: query required: false schema: type: string description: >- Только для типизированной ленты событий. Значение `next_cursor` предыдущей страницы. Недействительный или пустой курсор возвращает 400. - name: event_type in: query required: false style: form explode: true schema: type: array maxItems: 20 items: type: string enum: - network_detected - signal_observed - network_active - network_in_review - network_resolved - network_dismissed - verification_attempt - transaction - login - rule_hit - case_linked - note_added description: >- Только для типизированной ленты событий. Типы событий для сохранения; значения можно повторять или разделять запятыми, не более 20 значений. По умолчанию сохраняются все типы. responses: '200': description: >- Без `contract`: `{results}`, сначала старые, без пагинации. С `contract=2`: `{results, next_cursor}`, сначала новые. content: application/json: schema: oneOf: - $ref: '#/components/schemas/NetworkTimeline' - $ref: '#/components/schemas/NetworkTimelinePage' examples: Default timeline: summary: Без contract value: results: - event_type: network_detected occurred_at: '2026-10-01T09:12:44Z' label: Network detected metadata: network_id: N-0042 - event_type: signal_observed occurred_at: '2026-10-12T16:03:10Z' label: device observed metadata: signal_type: device subject_count: 3 is_hub: false - event_type: network_in_review occurred_at: '2026-10-12T16:30:00Z' label: Network in_review metadata: reason: Shared device across three new accounts. Typed timeline: summary: С contract=2 value: results: - id: monitoring_event:9b2f1c3e-4d5a-4b6c-8d7e-0f1a2b3c4d5e event_type: login occurred_at: '2026-10-12T18:41:02Z' ingested_at: '2026-10-12T18:41:03Z' label: Login metadata: {} account: node_id: vendor_user:5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f node_type: account uuid: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f vendor_data: user-1042 display_name: Alex Example ownership: owned route: kind: user id: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee source_ref: kind: monitoring_event id: 9b2f1c3e-4d5a-4b6c-8d7e-0f1a2b3c4d5e ownership: owned verification_attempt: null transaction: null login: action: auth.login succeeded: true status: APPROVED ip: address: 203.0.113.24 country_code: ES city: Madrid connection_type: null is_vpn_or_tor: false is_data_center: false device: fingerprint: fp_0a1b2c3d label: Chrome · Android is_first_login: false is_new_device: true rule_hit: null case_linked: null note_added: null - id: session:1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f event_type: verification_attempt occurred_at: '2026-10-12T16:03:10Z' ingested_at: '2026-10-12T16:03:10Z' label: Verification attempt 2 of 2 metadata: {} account: node_id: vendor_user:5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f node_type: account uuid: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f vendor_data: user-1042 display_name: Alex Example ownership: owned route: kind: user id: 5f6e7d8c-9b0a-4c1d-8e2f-3a4b5c6d7e8f application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee source_ref: kind: session id: 1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f ownership: owned route: kind: session id: 1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f application_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee verification_attempt: session_id: 1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f session_number: 1287 attempt: 2 attempt_count: 2 status: Approved status_changed_at: '2026-10-12T16:05:41Z' decline_reasons: [] transaction: null login: null rule_hit: null case_linked: null note_added: null - id: signal_observed:8d7c6b5a-4e3f-4a2b-9c1d-0e9f8a7b6c5d event_type: signal_observed occurred_at: '2026-10-12T16:03:10Z' ingested_at: '2026-10-01T09:12:44Z' label: device observed metadata: signal_type: device subject_count: 3 is_hub: false account: null source_ref: null verification_attempt: null transaction: null login: null rule_hit: null case_linked: null note_added: null next_cursor: >- eyJ0IjoiMjAyNi0xMC0xMlQxNjowMzoxMCswMDowMCIsImMiOiIyMDI2LTEwLTAxVDA5OjEyOjQ0KzAwOjAwIiwiciI6MSwidSI6IjhkN2M2YjVhLTRlM2YtNGEyYi05YzFkLTBlOWY4YTdiNmM1ZCJ9 '400': description: >- При наличии `contract`: недопустимое значение `contract`, `limit`, `cursor` или `event_type`. content: application/json: examples: Unsupported contract: summary: Неподдерживаемый контракт value: contract: - '"3" is not a valid choice.' Invalid cursor: summary: Недопустимый курсор value: cursor: - This cursor is not valid. Reload the feed. Limit too large: summary: Лимит слишком велик value: limit: - Ensure this value is less than or equal to 500. Unknown event type: summary: Неизвестный тип события value: event_type: '0': - '"logout" is not a valid choice.' '401': description: Отсутствуют или недействительны учетные данные. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Присутствует при ошибках с кодом, например `networks_not_entitled`. examples: Missing or invalid credentials: summary: Отсутствуют или недействительны учетные данные value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- API-ключ принадлежит другому приложению или имеет ограниченный доступ: для endpoint’ов раздела Networks требуется ключ с полным доступом. Для токена участника консоли требуется `read:networks`. Также возвращается с `code: networks_not_entitled`, если Networks не включен для организации. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Присутствует при ошибках с кодом, например `networks_not_entitled`. examples: Networks not enabled: summary: Сети не включены value: detail: >- Networks is disabled for this organization. Contact Didit support if you believe this is an error. code: networks_not_entitled Restricted API key: summary: Ограниченный API-ключ value: detail: This API key has no access to this endpoint. No permission: summary: Нет разрешения value: detail: You do not have permission to perform this action. '404': description: Сеть не найдена (или не видна этому приложению). content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \ -H 'x-api-key: YOUR_API_KEY' - lang: curl label: curl (typed timeline) source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/3fa85f64-5717-4562-b3fc-2c963f66afa6/timeline/?contract=2&limit=50&event_type=verification_attempt,login' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.networks.retrieve_timeline( "n3a5e000-0000-4000-8000-000000000001", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.networks.retrieveTimeline("n3a5e000-0000-4000-8000-000000000001"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Networks.RetrieveTimeline(ctx, \"n3a5e000-0000-4000-8000-000000000001\", didit.NetworksRetrieveTimelineParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.networks().retrieveTimeline("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieveTimeline('n3a5e000-0000-4000-8000-000000000001'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.networks.retrieve_timeline("n3a5e000-0000-4000-8000-000000000001") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Networks.RetrieveTimelineAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkTimeline: title: Default timeline (no contract) type: object description: 'Без `contract`: собственные события сети, сначала старые, без пагинации.' properties: results: type: array items: $ref: '#/components/schemas/NetworkTimelineEvent' NetworkTimelinePage: title: Typed timeline page (contract=2) type: object description: 'С `contract=2`: одна страница типизированных событий, сначала новые.' properties: results: type: array items: $ref: '#/components/schemas/NetworkTypedTimelineEvent' next_cursor: type: string nullable: true description: >- Передайте как `cursor` для чтения следующей страницы. Имеет значение null на последней странице. NetworkTimelineEvent: type: object properties: event_type: type: string description: >- например, network_detected, signal_observed, network_in_review, network_resolved, network_dismissed. occurred_at: type: string format: date-time nullable: true label: type: string metadata: type: object NetworkTypedTimelineEvent: type: object description: >- Одно типизированное событие таймлайна: четыре поля по умолчанию, а также его id, время сохранения в Didit, аккаунт участника и запись, к которым оно относится, и блок деталей его типа события. Остальные блоки деталей равны null. properties: id: type: string description: '`:`, уникальный в пределах хронологии.' example: session:3fa85f64-5717-4562-b3fc-2c963f66afa6 event_type: type: string enum: - network_detected - signal_observed - network_active - network_in_review - network_resolved - network_dismissed - verification_attempt - transaction - login - rule_hit - case_linked - note_added occurred_at: type: string format: date-time description: Когда это произошло. ingested_at: type: string format: date-time description: Когда Didit сохранил это. label: type: string description: >- Короткая метка на английском языке, например `Verification attempt 2 of 3`. metadata: type: object description: >- Для собственных событий сети используются те же метаданные, что и в таймлайне по умолчанию. В противном случае пусто. account: allOf: - $ref: '#/components/schemas/NetworkTimelineAccount' nullable: true description: >- Учётная запись участника. Null для собственных событий сети, `case_linked` и `note_added`. source_ref: allOf: - $ref: '#/components/schemas/NetworkTimelineSourceRef' nullable: true description: >- Исходная запись. Null для собственных событий сети и для `note_added`. verification_attempt: allOf: - $ref: '#/components/schemas/NetworkTimelineAttempt' nullable: true description: Устанавливается для событий `verification_attempt`. transaction: allOf: - $ref: '#/components/schemas/NetworkTimelineTransaction' nullable: true description: Устанавливается для событий `transaction`. login: allOf: - $ref: '#/components/schemas/NetworkTimelineLogin' nullable: true description: Устанавливается для событий `login`. rule_hit: allOf: - $ref: '#/components/schemas/NetworkTimelineRuleHit' nullable: true description: Устанавливается для событий `rule_hit`. case_linked: allOf: - $ref: '#/components/schemas/NetworkTimelineCaseLinked' nullable: true description: Устанавливается для событий `case_linked`. note_added: allOf: - $ref: '#/components/schemas/NetworkTimelineNoteAdded' nullable: true description: >- Устанавливается для событий `note_added`. Никогда не возвращается для API-ключа. NetworkTimelineAccount: type: object description: Учётная запись участника, к которой относится событие. properties: node_id: type: string description: >- `:`, где kind может быть `vendor_user`, `vendor_business` или `transaction_party`. example: vendor_user:3fa85f64-5717-4562-b3fc-2c963f66afa6 node_type: type: string enum: - account - business_account - transaction_party uuid: type: string format: uuid vendor_data: type: string nullable: true display_name: type: string nullable: true ownership: type: string enum: - owned - organization description: >- `owned`, когда запись принадлежит приложению, которое вы вызвали (для участника консоли: приложению, к которому ему был предоставлен доступ). `organization`, когда она принадлежит другому приложению вашей организации. route: $ref: '#/components/schemas/NetworkTimelineRoute' NetworkTimelineSourceRef: type: object description: Запись, из которой было считано событие. properties: kind: type: string enum: - session - business_session - transaction - monitoring_event - case id: type: string format: uuid ownership: type: string enum: - owned - organization description: >- `owned`, когда запись принадлежит приложению, которое вы вызвали (для участника консоли: приложению, к которому ему был предоставлен доступ). `organization`, когда она принадлежит другому приложению вашей организации. route: allOf: - $ref: '#/components/schemas/NetworkTimelineRoute' description: Отсутствует для `monitoring_event` и `case`. NetworkTimelineAttempt: type: object description: Одна сессия верификации аккаунта. properties: session_id: type: string format: uuid description: UUID сессии или UUID бизнес-сессии для компании. session_number: type: integer nullable: true attempt: type: integer description: Позиция этой сессии среди сессий аккаунта в порядке создания. attempt_count: type: integer description: Сколько сессий у аккаунта. status: type: string description: Статус сессии, например `Approved` или `Declined`. status_changed_at: type: string format: date-time nullable: true decline_reasons: type: array items: $ref: '#/components/schemas/NetworkTimelineDeclineReason' description: >- Только для отклонённой сессии: её предупреждения, сначала самые старые, по одному на предупреждение. В противном случае пусто. NetworkTimelineTransaction: type: object description: >- Транзакция, в которой участвовал аккаунт участника, датированная датой её совершения. properties: transaction_id: type: string format: uuid transaction_number: type: integer nullable: true transaction_type: type: string action_type: type: string amount: allOf: - $ref: '#/components/schemas/NetworkTimelineAmount' nullable: true description: Null, когда у транзакции нет суммы. status: type: string decision_reason_code: type: string nullable: true decision_reason_label: type: string nullable: true party_role: type: string description: >- Роль счёта в транзакции: `APPLICANT`, `REMITTER`, `BENEFICIARY` или `COUNTERPARTY`. NetworkTimelineLogin: type: object description: Событие входа, отправленное вами для лица через API событий. properties: action: type: string description: >- `.`: `auth.login` или `security.login_succeeded` для входа, `auth.login_failed` или `security.login_failed` для неудачного. succeeded: type: boolean status: type: string description: Статус события. ip: allOf: - $ref: '#/components/schemas/NetworkTimelineIP' nullable: true description: Null, когда у события нет IP-адреса. device: allOf: - $ref: '#/components/schemas/NetworkTimelineDevice' nullable: true description: >- Null, когда у события нет цифрового отпечатка устройства или контекста. is_first_login: type: boolean description: Первый зафиксированный успешный вход в учётную запись. is_new_device: type: boolean description: >- Успешный вход с устройства, с которого ранее не совершалось ни одного успешного входа в этот аккаунт. Никогда не принимает значение true при первом входе. NetworkTimelineRuleHit: type: object description: >- Правило в продакшне, сработавшее на транзакцию или событие участника. Срабатывания в тестовом режиме не включены. properties: rule_id: type: string format: uuid rule_title: type: string rule_category: type: string rule_source: type: string severity: type: string nullable: true score_delta: type: integer status_target: type: string nullable: true action_summary: type: string nullable: true NetworkTimelineCaseLinked: type: object description: >- Кейс, открытый для сети в вашей организации. Поле `source_ref.ownership` указывает, принадлежит ли он вызванному вами приложению. properties: case_id: type: string format: uuid case_number: type: string nullable: true status: type: string author_email: type: string nullable: true author_name: type: string nullable: true NetworkTimelineNoteAdded: type: object description: Заметка, оставленная в сети. Текст заметки не включён. properties: note_id: type: string format: uuid author_email: type: string NetworkTimelineRoute: type: object description: >- Где открывается запись: ее тип, UUID и приложение, которому она принадлежит. properties: kind: type: string description: >- `user`, `business` или `transaction_party` для аккаунта; `session`, `business_session` или `transaction` для записи-источника. id: type: string format: uuid application_id: type: string format: uuid NetworkTimelineDeclineReason: type: object properties: risk: type: string description: Код предупреждения. feature: type: string description: Функция, вызвавшая предупреждение. short_description: type: string NetworkTimelineAmount: type: object properties: value: type: string description: Десятичная сумма в виде строки. currency: type: string direction: type: string nullable: true NetworkTimelineIP: type: object properties: address: type: string country_code: type: string nullable: true city: type: string nullable: true connection_type: type: string nullable: true description: Метка типа подключения для адреса в виде произвольного текста. is_vpn_or_tor: type: boolean is_data_center: type: boolean NetworkTimelineDevice: type: object properties: fingerprint: type: string nullable: true label: type: string nullable: true description: >- Понятная метка устройства, сформированная на основе контекста устройства из события. 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.