> ## 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: фильтры по статусу, сигналу, паттерну, уровню риска, размеру и дате, режим обмена и счётчики. Промпт для API списка Networks Скопировать промпт в буфер обмена \

\`List fraud networks for my Didit application through the Management API.

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

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.

Goal:
\- Retrieve the same clustered fraud networks the Console's Networks list shows: applicants, businesses, or transaction parties linked by shared device, IP, face, document number, phone, email, or address signals, within my own organization only.

Useful query params:
\- status=active,in_review,resolved,dismissed (comma-separated). Omit to exclude dismissed networks.
\- scope=identity|transactions: transactions keeps networks whose members are all transaction parties, identity keeps every other network. Omit for both. Any other value is a 400.
\- signal_type=ip_address,device,face,document_number,phone,email,address (comma-separated)
\- pattern_type=exact_same_device,similar_device,same_ip_address,same_address,similar_selfie_backgrounds,similar_poa_documents,same_document_number,same_phone_number,same_email (comma-separated)
\- risk_band=low,medium,high (comma-separated)
\- min_size, max_size - member count bounds
\- assignee=unassigned,,me (comma-separated, any value matches). me needs a console member token; an API key gets a 400.
\- priority=low,medium,high,none (comma-separated; none is a network without a priority). Any other value is a 400.
\- risk_min - minimum risk score, a whole number from 0 to 100. A value that is not a whole number is a 400.
\- has_case=true|false - networks your application opened a case for, or the others
\- date_from, date_to - ISO 8601 date/datetime bounds on activity
\- q - free-text search across network name, member names, and the network id (e.g. N-0001)
\- ordering=risk_score|-risk_score|last_activity_at|-last_activity_at|first_activity_at|-first_activity_at|network_number|-network_number (default -risk_score,-last_activity_at)
\- limit (1-500, default 100), offset
\- summary=true|false: false returns the page and its count only, without kpis and counts. Defaults to true. Any other value is a 400.

Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/?status=active,in_review&ordering=-risk_score" \
-H "x-api-key: YOUR_API_KEY"

Response shape:
\{"count": int, "next": int|null, "previous": int|null, "results": [NetworkListItem, ...], "kpis": {...}, "counts": {...}, "sharing_mode": "off"|"private"|"global", "cross_org_available": bool, "cross_org_unavailable_reason": "plan"|"sharing_mode"|null}
next/previous are offsets, not URLs - null next means the last page.
Each NetworkListItem has uuid, network_id (e.g. "N-0001"), name, status (active|in_review|resolved|dismissed), risk {score, band, bar}, pattern_types, signal_types, member_counts, member_status, signal_coverage, first_activity_at, last_activity_at.
kpis carries active, in_review, applicants_involved, detected_this_period, false_positive_rate, each as {value, delta}, computed over the filtered result set.
counts carries scopes {all, identity, transactions}, views {all, active, in_review, resolved, dismissed, mine, high_risk} and facets {total, last_activity_days {"7", "30", "90"}, risk_min {"50", "80"}, signal_types {one count per signal type}, priority {low, medium, high, none}, assignee {me, unassigned, users: [{uuid, full_name, email, count}]}, has_case, min_size {"10"}}.
scopes count every network visible to this application; views count the visible networks inside the selected scope; facets count the networks in the selected scope and status view. The other filters do not change counts. mine and assignee.me are always 0 for an API key.
kpis and counts are omitted when summary=false.

Cross-organization fields (on every response, whatever summary says):
\- sharing_mode: the organization's cross-organization sharing mode. Only global compares networks across organizations; private and off keep them to the organization's own history.
\- cross_org_available: whether cross-organization signals apply to this organization. They need the Enterprise plan and the global sharing mode.
\- cross_org_unavailable_reason: plan (the organization's plan does not include the cross-organization fraud network; it needs the Enterprise plan, whatever the sharing mode), sharing_mode (the plan includes it, but sharing is private or off), or null when cross_org_available is true. plan is checked first.

Notes:
\- Sandbox applications never return networks - clustering excludes sandbox data entirely.
\- Networks are clustered organization-wide, but this endpoint only returns networks with at least one member visible to this application.

Failure modes:
\- 401: missing or invalid x-api-key. {"detail": "Authentication credentials were not provided or are invalid."}
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs list:networks. {"detail": "You do not have permission to perform this action."} or {"detail": "This API key has no access to this endpoint."}
\- 403 with code: Networks is not enabled for the organization. {"detail": "Networks is disabled for this organization. Contact Didit support if you believe this is an error.", "code": "networks_not_entitled"}
\- 400: an invalid filter, ordering, limit or offset, or summary that is not true or false. {"summary": ["Must be \\"true\\" or \\"false\\"."]}

Side effects: none, pure read.

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

\
Вставьте в Перечислите сети мошенничества, обнаруженные для вашей организации. По умолчанию список упорядочен по оценке риска: сначала самые высокие, затем по времени последней активности. Каждый фильтр, доступный в списке Networks в консоли, передаётся как параметр запроса, включая поиск по свободному тексту `q` и те же чипы статуса, сигнала, паттерна и диапазона риска. Параметры `assignee`, `priority`, `risk_min` и `has_case` соответствуют опциям «исполнитель», «приоритет», «минимальный риск» и «связанный кейс», которые учитывает `counts.facets`. `assignee=me` требует токен участника консоли; при использовании API-ключа возвращается `400`.> [!NOTE] > > В приложениях в песочнице сетей никогда не бывает. Кластеризация выполняется только на продакшн-данных.## Режим обмена и сигналы между организациямиКаждый ответ содержит `sharing_mode`, `cross_org_available` и `cross_org_unavailable_reason` вашей организации.| Поле | Значение | | - | - | | `sharing_mode` | Режим обмена данными между организациями. Только `global` сравнивает сети между организациями; `private` и `off` оставляют сети только в истории самой организации. | | `cross_org_available` | Применяются ли к вашей организации сигналы между организациями. Для этого нужны и тариф Enterprise, и режим `global`. | | `cross_org_unavailable_reason` | `plan`, если ваш тариф не включает сеть мошенничества между организациями (нужен тариф Enterprise), независимо от режима обмена. `sharing_mode`, если тариф это включает, но ваш режим обмена `private` или `off`. `null`, если `cross_org_available` равно `true`. |Тариф проверяется первым: если тариф ниже Enterprise, причина будет `plan`, даже когда режим обмена `global`.## Счётчики и параметр summary`kpis` агрегирует сети, которые соответствуют вашим фильтрам, а `counts` агрегирует все сети, которые видит ваше приложение, поэтому оба показателя требуют больше ресурсов, чем сама страница. Передайте `summary=false`, если нужны только страница и её `count`: тогда ответ не содержит `kpis` и `counts`. `summary` принимает только `true` или `false`; любое другое значение возвращает `400`.`counts` содержит числа, на которых основаны представления списка и опции фильтров; каждая сеть учитывается один раз:| Ключ | Что считает | | - | - | | `scopes` | Каждую видимую сеть (`all`), разделённую на `transactions` (все участники являются сторонами транзакции) и `identity` (все остальные сети). | | `views` | Видимые сети в выбранном `scope` (`all`) по статусу (`active`, `in_review`, `resolved`, `dismissed`), назначенные участнику консоли, выполняющему вызов (`mine`), и `high_risk` (оценка риска 80 и выше, не отклонённые). | | `facets` | Сети в выбранной области (`scope`) и представлении по `status` (`total`), по времени последней активности (`last_activity_days`: 7, 30, 90), по минимальному риску (`risk_min`: 50, 80), по типу сигнала, по приоритету (включая `none`), по исполнителю (`me`, `unassigned` и по одной записи для каждого исполнителя в `users`), сети, для которых ваше приложение открыло кейс (`has_case`), и сети с не менее чем 10 участниками (`min_size`). |Фильтры, отличные от `scope` и `status`, не меняют `counts`. `views.mine` и `facets.assignee.me` всегда равны `0` для API-ключа, поскольку участник консоли в этом случае не выполняет вызов.## ДоступEndpoint'ам Networks нужен [API-ключ](https://docs.didit.me/ru/console/api-keys.md) с полным доступом. Ключ с ограниченным доступом получает `403`. Токену участника консоли нужно разрешение `list:networks`. Если Networks не включён для вашей организации, каждый endpoint Networks возвращает `403` с `"code": "networks_not_entitled"`.## Связанное- [Получить сеть](https://docs.didit.me/ru/management-api/networks/get.md) - [Граф сети](https://docs.didit.me/ru/management-api/networks/graph.md) - [Networks (консоль)](https://docs.didit.me/ru/console/networks.md) ## OpenAPI ````yaml ru/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/ 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/: get: tags: - Networks summary: Получить список сетей description: >- Получить список мошеннических сетей, обнаруженных в организации этого приложения, по умолчанию сначала с наивысшим риском. По умолчанию отклонённые сети исключены; передайте статус, чтобы включить их. Приложения в песочнице никогда не содержат сетей: кластеризация полностью исключает данные песочницы. Каждый ответ содержит `sharing_mode` организации и информацию о том, применяются ли к ней межорганизационные сигналы (`cross_org_available`, `cross_org_unavailable_reason`). `kpis` агрегируют сети, соответствующие вашим фильтрам, а `counts` агрегируют все сети, видимые приложению; передайте `summary=false`, чтобы пропустить оба параметра, если вам нужна только страница. Требуется API-ключ с полным доступом или разрешение `list:networks` для участника консоли. operationId: list_networks 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: status in: query schema: type: string description: >- Разделённый запятыми список статусов для включения: active,in_review,resolved,dismissed. Опустите, чтобы исключить dismissed. - name: scope in: query schema: type: string enum: - identity - transactions description: >- `transactions` оставляет сети, все участники которых являются сторонами транзакции; `identity` оставляет все остальные сети. Опустите для обеих. Это также сужает `counts.views` и `counts.facets`. Любое другое значение возвращает 400. - name: signal_type in: query schema: type: string description: >- Разделённый запятыми список типов сигналов: ip_address,device,face,document_number,phone,email,address. - name: pattern_type in: query schema: type: string description: >- Разделённый запятыми список типов шаблонов, например exact_same_device,same_email. - name: risk_band in: query schema: type: string description: 'Разделённые запятыми диапазоны: low,medium,high.' - name: min_size in: query schema: type: integer description: Минимальное количество участников. - name: max_size in: query schema: type: integer description: Максимальное количество участников. - name: assignee in: query schema: type: string description: >- Разделённые запятыми ответственные лица: `unassigned`, email участников (без учёта регистра) или `me` для вызывающего участника консоли. Сеть совпадает с любым значением. Для `me` требуется token участника консоли: API-ключ вернёт ошибку 400 `{"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}`. - name: priority in: query schema: type: string description: >- Разделённые запятыми приоритеты: `low`, `medium`, `high` или `none` для сетей без приоритета. Любое другое значение возвращает 400 `{"priority": "Unknown priority: ."}`. - name: risk_min in: query schema: type: integer minimum: 0 maximum: 100 description: >- Минимальная оценка риска, целое число от 0 до 100. Нецелое число возвращает 400 `{"risk_min": "Use a whole number from 0 to 100."}`. - name: has_case in: query schema: type: boolean description: >- `true` оставляет сети, по которым ваше приложение открыло кейс, а `false` оставляет остальные. Любое другое значение игнорируется. - name: date_from in: query schema: type: string format: date description: >- Нижняя граница для last_activity_at (дата или дата и время по стандарту ISO 8601). - name: date_to in: query schema: type: string format: date description: >- Верхняя граница first_activity_at (дата или дата и время в формате ISO 8601). - name: q in: query schema: type: string description: >- Полнотекстовый поиск по названию сети, именам участников, network_id (N-0001) и точным токенам pattern_type. - name: ordering in: query schema: type: string description: >- Одно из значений: risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. По умолчанию: -risk_score,-last_activity_at. - name: limit in: query schema: type: integer default: 100 minimum: 1 maximum: 500 description: Размер страницы, 1–500. По умолчанию 100. - name: offset in: query schema: type: integer default: 0 minimum: 0 description: Смещение первой записи, начиная с нуля. - name: summary in: query schema: type: boolean default: true description: >- `false` возвращает только страницу и её `count`, без `kpis` и `counts`. По умолчанию `true`. Любое значение, кроме `true` или `false`, возвращает 400. responses: '200': description: >- Список сетей с пагинацией, с режимом общего доступа организации и доступностью между организациями, а также с `kpis` и `counts`, если не указано `summary=false`. content: application/json: schema: type: object properties: count: type: integer next: type: integer nullable: true description: >- Смещение следующей страницы или null на последней странице. previous: type: integer nullable: true results: type: array items: $ref: '#/components/schemas/NetworkListItem' kpis: type: object description: >- Каждый ключ представляет собой {value, delta} по результатам, соответствующим текущим фильтрам. Опускается при `summary=false`. properties: active: type: object in_review: type: object applicants_involved: type: object detected_this_period: type: object false_positive_rate: type: object counts: $ref: '#/components/schemas/NetworkListCounts' sharing_mode: type: string enum: - 'off' - private - global description: >- Режим межорганизационного обмена данными организации. Только `global` сравнивает сети между организациями; `private` и `off` оставляют их только в истории этой организации. example: global cross_org_available: type: boolean description: >- Применяются ли сигналы между организациями к этой организации. Для них требуются как тариф Enterprise, так и режим общего доступа `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Причина, по которой межорганизационные сигналы не применяются; проверяются в следующем порядке. `plan`: тариф организации не включает межорганизационную сеть защиты от мошенничества (требуется тариф Enterprise) независимо от режима обмена данными. `sharing_mode`: тариф включает её, но режим обмена установлен как `private` или `off`. Null, если `cross_org_available` равен `true`. example: null required: - count - next - previous - results - sharing_mode - cross_org_available - cross_org_unavailable_reason '400': description: >- Недопустимое значение фильтра, сортировки, пагинации или параметра `summary`. content: application/json: examples: Invalid summary: summary: Недопустимая сводка value: summary: - Must be "true" or "false". Invalid scope: summary: Недопустимая область действия (scope) value: scope: - Use identity or transactions. Unsupported ordering: summary: Неподдерживаемый порядок сортировки value: - Unsupported ordering. '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 требуется ключ с полным доступом. Для токена участника консоли требуется `list: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. 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/?status=active,in_review&ordering=-risk_score' \ -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() for item in client.networks.list(): print(item) - 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(); for await (const item of didit.networks.list()) { console.log(item); } - 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\niter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})\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_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); for (var item : client.networks().list()) { System.out.println(item); } - lang: php label: PHP source: |- networks->list() as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new didit.networks.list.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, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); await foreach (var item in await client.Networks.ListAsync()) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: >- Понятный человеку порядковый идентификатор в рамках организации, например N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Статус жизненного цикла сети. Отличается от outcome_status по заявителям внутри сети (approved/in_review/declined/not_completed). risk: $ref: '#/components/schemas/NetworkRiskDisplay' pattern_types: type: array items: type: string enum: - exact_same_device - similar_device - same_ip_address - same_address - similar_selfie_backgrounds - similar_poa_documents - same_document_number - same_phone_number - same_email description: Паттерны кластеризации, обнаруженные в этой сети. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Уникальные типы сигналов, присутствующие в этой сети. member_counts: type: object description: >- Количество участников по категориям (например, всего, по outcome_status). member_status: type: object description: Разбивка участников по outcome_status. signal_coverage: type: object description: Охват участников этой сети по signal_type. first_activity_at: type: string format: date-time nullable: true last_activity_at: type: string format: date-time nullable: true NetworkListCounts: type: object description: >- Количество сетей для представлений списка и параметров фильтрации; каждая сеть учитывается один раз. Возвращается, только если `summary` не равно `false`. `scopes` подсчитывает все сети, видимые приложению. `views` подсчитывает видимые сети внутри выбранного `scope`. `facets` подсчитывает сети в выбранном `scope` и представлении `status` (отклонённые сети исключаются, если `status` не включает их). Другие фильтры списка не влияют на эти подсчёты. properties: scopes: type: object description: Видимые сети по продуктам. properties: all: type: integer identity: type: integer description: Каждая другая сеть. transactions: type: integer description: Сети, все участники которых являются сторонами транзакции. views: type: object description: >- Видимые сети внутри выбранного `scope` по статусу, плюс два сохранённых представления. properties: all: type: integer active: type: integer in_review: type: integer resolved: type: integer dismissed: type: integer mine: type: integer description: >- Сети, назначенные вызывающему участнику консоли. Всегда 0 для API-ключа. high_risk: type: integer description: Сети с оценкой риска 80 или выше, которые не были отклонены. facets: type: object description: >- Количество для каждого варианта фильтра в рамках выбранного `scope` и представления статусов. properties: total: type: integer description: Сети в выбранном `scope` и представлении статуса. last_activity_days: type: object description: >- Сети с активностью за последние 7, 30 и 90 дней, с ключом по количеству дней. properties: '7': type: integer '30': type: integer '90': type: integer risk_min: type: object description: >- Сети с оценкой риска не менее 50 и не менее 80, с ключом по порогу. properties: '50': type: integer '80': type: integer signal_types: type: object description: Сети как минимум с одним сигналом каждого типа. properties: ip_address: type: integer device: type: integer face: type: integer document_number: type: integer phone: type: integer email: type: integer address: type: integer priority: type: object description: Сети по приоритету. `none` подсчитывает сети без приоритета. properties: low: type: integer medium: type: integer high: type: integer none: type: integer assignee: type: object description: Сети по назначенным исполнителям. properties: me: type: integer description: >- Назначено вызвавшему участнику консоли. Всегда 0 для API-ключа. unassigned: type: integer description: Никому не назначен. users: type: array description: >- Одна запись на каждого назначенного ответственного, сначала с наибольшим количеством сетей. items: type: object properties: uuid: type: string format: uuid full_name: type: string description: >- Имя назначенного исполнителя или адрес его электронной почты, если имя не указано. email: type: string count: type: integer has_case: type: integer description: Сети, по которым это приложение открыло кейс. min_size: type: object description: >- Сети как минимум с 10 участниками, с ключом по минимальному размеру. properties: '10': type: integer NetworkRiskDisplay: type: object properties: score: type: integer description: Оценка риска, 0-100. band: type: string enum: - low - medium - high description: >- Диапазон, в котором отображается оценка. high >= 70, medium >= 40, иначе low. bar: type: number format: float description: Нормализованное значение от 0 до 1 для отображения шкалы риска. 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.