Таймлайн сети мошенников API

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'

{
  "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."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

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'

{
  "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."
      }
    }
  ]
}

Получите историю событий сети. Без 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 событий	`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.

Связанные материалы

Авторизации

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.

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

organization_id

string<uuid>

обязательно

UUID организации.

application_id

string<uuid>

обязательно

UUID приложения.

network_uuid

string<uuid>

обязательно

UUID сети.

Пример:

"n3a5e000-0000-4000-8000-000000000001"

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

contract

enum<string>

2 возвращает типизированную хронологию. Опустите его для хронологии по умолчанию. Любое другое значение возвращает 400.

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

2

limit

integer

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

Только для типизированной ленты событий. Количество событий на странице, от 1 до 500. По умолчанию 100.

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

cursor

string

Только для типизированной ленты событий. Значение next_cursor предыдущей страницы. Недействительный или пустой курсор возвращает 400.

event_type

enum<string>[]

Только для типизированной ленты событий. Типы событий для сохранения; значения можно повторять или разделять запятыми, не более 20 значений. По умолчанию сохраняются все типы.

Maximum array length: 20

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

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Ответ

Без contract: {results}, сначала старые, без пагинации. С contract=2: {results, next_cursor}, сначала новые.

Default timeline (no contract)
Typed timeline page (contract=2)

Без contract: собственные события сети, сначала старые, без пагинации.

results

object[]

Show child attributes

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

​Типизированная хронология

​Типы событий

​Аккаунты и записи

​Связанные материалы

Авторизации

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

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

Ответ

Типизированная хронология

Типы событий

Аккаунты и записи

Связанные материалы