> ## 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 для получения сети Скопировать промпт в буфер обмена \

\`Retrieve a single fraud network's full detail through the Management API.

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

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, from list networks.

Response 200: NetworkDetailResponse. Everything in the list-item shape (uuid, network_id, name, status, risk, pattern_types, signal_types, member_counts, member_status, signal_coverage, first_activity_at, last_activity_at), plus stats, fraud_tags, risk_signals (residential_proxy_reuse, email_intelligence, phone_intelligence summaries), reviewed_at, reviewed_by, review_reason, notes_count, and:
\- sharing_mode, cross_org_available, cross_org_unavailable_reason: the same fields as on list networks. sharing_mode is off|private|global (only global compares networks across organizations). cross_org_available is true only with the Enterprise plan and global sharing. cross_org_unavailable_reason is plan (checked first), sharing_mode, or null when available.
\- tags: my application's tags on the network, oldest first. Each is {uuid, name, color, source (didit|custom), added_by (the console member's email, or null when an API key added it), added_at}. Each application sees only its own tags. fraud_tags is separate and unchanged: the tags the network's members carry.
\- outcomes: {approved, declined, in_review, total}. Each member I may see counts once, by the status of their most recent verification that reached a decision. total counts members with at least one verification; a member whose verifications are all undecided counts only in total. Transaction parties are not counted.
\- patterns: [{type: "background", score, members, reason, computed_at}]. score is 0 to 1 with 4 decimals: the mean similarity of every pair of member selfie backgrounds, the person masked out. It reads the newest selfie of each person (at most the 50 newest, age assurance sessions excluded) across the whole network, not only my applications.
\- reason "computing": score, members and computed_at are null; read the network again later.
\- reason "not_enough_selfies": fewer than two members have a usable selfie; score is null and members is 0 or 1.
\- reason null: score is set, members is how many selfies were compared, computed_at is when.

Failure modes:
\- 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: the network does not change. A read that finds no current background score schedules its computation.

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

\
Вставьте в Получите одну сеть со всем необходимым для отображения панели обзора сети: её разбивкой по рискам, обнаруженными тегами мошенничества и сводками сигналов риска, а также полями, общими со списком. В деталях также указаны теги вашего приложения для сети, статусы верификаций её участников и степень сходства их фонов на селфи.## Теги`tags` содержит теги вашего приложения для сети, от старых к новым. Каждое приложение видит и изменяет только свои теги. `added_by` содержит email участника консоли, который добавил тег, или `null`, если тег добавил API-ключ. Для изменения тегов используйте [Добавить тег сети](https://docs.didit.me/ru/management-api/networks/add-tag.md) и [Удалить тег сети](https://docs.didit.me/ru/management-api/networks/remove-tag.md). `fraud_tags` не меняется: он содержит теги, которые имеют участники сети.## Результаты участников`outcomes` считает людей и компании в сети, которые вы можете видеть, при этом каждый учитывается один раз.| Ключ | Что считается | | - | - | | `approved` | Участники, у которых последняя верификация, по которой вынесено решение, одобрена | | `declined` | Участники, у которых последняя верификация, по которой вынесено решение, отклонена | | `in_review` | Участники, у которых последняя верификация, по которой вынесено решение, находится на проверке | | `total` | Участники, у которых есть хотя бы одна верификация, с решением или без него |Участник, отклонённый, а затем одобренный при повторной попытке, учитывается как `approved`. Участник, по всем верификациям которого решение не вынесено (не начаты, в процессе, истекли или прерваны), учитывается только в `total`. Стороны транзакций верификацию не проходят и не учитываются.## Шаблон фона селфи`patterns` сейчас содержит один элемент с `type`, равным `background`. Его `score` от 0 до 1 показывает среднее сходство всех пар фонов селфи участников без учёта самого человека. Значение, близкое к 1, говорит о том, что селфи, вероятно, сделаны в одном месте. Однотонные стены похожего цвета тоже могут давать высокий балл, поэтому рассматривайте оценку как основание для проверки, а не как доказательство. Оценка считает самое новое селфи каждого человека, не более 50 самых новых, и не учитывает сессии верификации возраста. Она охватывает всю сеть, а не только участников ваших приложений.| `reason` | `score` | `members` | Что делать | | - | - | - | - | | `null` | от 0 до 1 | Сравнённые селфи | Используйте оценку. `computed_at` показывает, когда она была вычислена. | | `computing` | `null` | `null` | Оценка для текущих участников вычисляется. Повторно запросите сеть позже. | | `not_enough_selfies` | `null` | `0` или `1` | Менее двух участников имеют пригодное селфи. |Селфи, которое нельзя прочитать или на котором слишком мало фона, не сравнивается, поэтому `members` может быть меньше числа людей в сети. Оценка всегда отражает текущие селфи участников. Если они меняются, например когда участник присоединяется к сети или покидает её, в деталях указывается `computing`, пока новая оценка не будет готова, либо `not_enough_selfies`, если осталось меньше двух участников.## Доступность между организациямиВ деталях указаны те же `sharing_mode`, `cross_org_available` и `cross_org_unavailable_reason`, что и в [списке сетей](https://docs.didit.me/ru/management-api/networks/list.md#режим-обмена-и-сигналы-между-организациями). Сигналы между организациями требуют одновременно тарифа Enterprise и режима обмена `global`.## Связанные страницы- [Список сетей](https://docs.didit.me/ru/management-api/networks/list.md) - [Добавить тег сети](https://docs.didit.me/ru/management-api/networks/add-tag.md) - [Удалить тег сети](https://docs.didit.me/ru/management-api/networks/remove-tag.md) - [Участники сети](https://docs.didit.me/ru/management-api/networks/members.md) - [Граф сети](https://docs.didit.me/ru/management-api/networks/graph.md) ## OpenAPI ````yaml ru/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/ 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}/: get: tags: - Networks summary: Получить сеть description: >- Получить полную информацию об одной сети: статистику, метки мошенничества и сигналы риска, а также `sharing_mode` организации и доступность между организациями, `tags` вашего приложения в сети, `outcomes` участников и оценки паттернов (`patterns`). Требуется API-ключ с полным доступом или разрешение `read:networks` для участника консоли. operationId: get_network 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 сети. responses: '200': description: Сведения о сети. content: application/json: schema: $ref: '#/components/schemas/NetworkDetailResponse' example: uuid: 3fa85f64-5717-4562-b3fc-2c963f66afa6 network_id: N-0042 name: null status: in_review risk: score: 82 band: high bar: 0.82 pattern_types: - exact_same_device - same_email signal_types: - device - email member_counts: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signal_coverage: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 first_activity_at: '2026-10-01T09:12:44Z' last_activity_at: '2026-10-12T16:03:10Z' stats: members: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signals: total: 2 by_type: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 fraud_tags: [] risk_signals: residential_proxy_reuse: detected: false signal_count: 0 max_subject_count: 0 email_intelligence: enriched_signal_count: 1 high_risk_count: 0 social_profile_count: 0 phone_intelligence: enriched_signal_count: 0 high_risk_count: 0 reviewed_at: '2026-10-12T16:30:00Z' reviewed_by: reviewer@example.com review_reason: Shared device across three new accounts. notes_count: 0 sharing_mode: global cross_org_available: true cross_org_unavailable_reason: null tags: - uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 name: SUSPICIOUS color: '#6366F1' source: custom added_by: null added_at: '2026-10-13T08:15:00Z' outcomes: approved: 1 declined: 1 in_review: 0 total: 3 patterns: - type: background score: 0.8125 members: 3 reason: null computed_at: '2026-10-13T08:00:00Z' '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/' \ -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( "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.retrieve("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.Retrieve(ctx, \"n3a5e000-0000-4000-8000-000000000001\")\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().retrieve("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieve('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("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.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkDetailResponse: description: >- Сведения о сети, а также режим обмена данными организации, применяются ли к ней межорганизационные сигналы, теги вашего приложения в сети, результаты участников и оценки паттернов. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: 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 tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- Теги вашего приложения в сети, сначала старые. Каждое приложение видит только свои теги. Поле `fraud_tags` существует отдельно и не изменяется: теги, присвоенные участниками сети. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: >- Оценки паттернов по всей сети. На данный момент один элемент: `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: >- Агрегированная статистика по сети (например, общее количество участников). fraud_tags: type: array items: type: object description: Теги паттернов мошенничества, выявленные в сети. risk_signals: type: object description: >- Сводка сигналов риска: residential_proxy_reuse, email_intelligence, phone_intelligence. reviewed_at: type: string format: date-time nullable: true reviewed_by: type: string nullable: true review_reason: type: string nullable: true properties: notes_count: type: integer minimum: 0 readOnly: true description: Количество приватных заметок аналитика в этом расследовании. NetworkTag: type: object description: Один из тегов вашего приложения в сети. properties: uuid: type: string format: uuid description: UUID тега, то же значение, что передается в `tag_uuid`. name: type: string color: type: string description: Шестнадцатеричный цвет (hex), например `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` для предустановленного тега Didit, `custom` для тега, созданного вашей командой. added_by: type: string nullable: true description: >- Электронная почта участника консоли, добавившего тег. Null, если он добавлен с помощью API-ключа. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Текущее состояние пользователей и компаний в сети. Каждый участник, которого вы можете видеть, учитывается один раз по статусу его последней верификации, по которой было вынесено решение. Стороны транзакции не учитываются. properties: approved: type: integer description: >- Участники, чья последняя верификация, по которой принято решение, была одобрена. declined: type: integer description: >- Участники, чья последняя верификация, по которой принято решение, была отклонена. in_review: type: integer description: >- Участники, чья последняя верификация, по которой принято решение, находится на проверке. total: type: integer description: >- Участники хотя бы с одной верификацией, завершённой или нет. Участник, у которого все верификации не завершены решением (не начаты, в процессе, истекли или прерваны), учитывается здесь и ни в каком другом ключе. NetworkPatternScore: type: object description: >- Насколько схож один из типов данных участников во всей сети. Паттерн не является сигналом: участников не связывает общее значение. properties: type: type: string enum: - background description: >- `background`: среднее сходство фонов селфи для каждой пары участников (человек маскируется). Учитывается самое свежее селфи каждого человека (не более 50 последних) и исключаются сессии подтверждения возраста. Охватывает всю сеть, а не только участников ваших приложений. score: type: number nullable: true minimum: 0 maximum: 1 description: >- От 0 до 1, округлено до 4 знаков после запятой. Null, когда задано поле `reason`. members: type: integer nullable: true description: >- Количество селфи участников, с которыми производилось сравнение. Селфи, которое невозможно прочитать или на котором слишком мало фона, не сравнивается. Равно null во время `computing`; 0 или 1 при `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Почему оценка отсутствует. `computing`: оценка для текущих участников вычисляется; повторно запросите данные сети позднее. `not_enough_selfies`: менее чем у двух участников есть пригодное селфи. Null, если оценка есть. computed_at: type: string format: date-time nullable: true description: Время расчёта оценки. Null во время `computing`. 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 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.