> ## 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 提示词
        将提示词复制到剪贴板



      
      

\<pre>

\`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.`

\</pre>



      
      

粘贴到

获取单个网络的完整信息，用于渲染网络概览面板：包括其风险明细、检测到的欺诈标签和风险信号摘要，以及与列表共有的字段。
详情还包含您的应用在该网络上的标签、其成员的验证状态，以及他们的自拍照背景有多相似。## 标签`tags` 按添加时间从早到晚列出您的应用在该网络上的标签。
每个应用只能查看和修改自己的标签。
`added_by` 是添加该标签的控制台成员的邮箱，若由 API 密钥添加则为 `null`。
使用 [添加网络标签](https://docs.didit.me/zh/management-api/networks/add-tag.md) 和 [移除网络标签](https://docs.didit.me/zh/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`。## 跨组织可用性详情中包含与[列出网络](https://docs.didit.me/zh/management-api/networks/list.md#共享模式与跨组织信号)相同的 `sharing_mode`、`cross_org_available` 和 `cross_org_unavailable_reason`。
跨组织信号需同时满足 Enterprise 套餐和 `global` 共享模式。## 相关内容- [列出网络](https://docs.didit.me/zh/management-api/networks/list.md)
- [添加网络标签](https://docs.didit.me/zh/management-api/networks/add-tag.md)
- [移除网络标签](https://docs.didit.me/zh/management-api/networks/remove-tag.md)
- [网络成员](https://docs.didit.me/zh/management-api/networks/members.md)
- [网络图谱](https://docs.didit.me/zh/management-api/networks/graph.md)


## OpenAPI

````yaml zh/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 密钥属于另一个应用，或者是一个访问权限受限的密钥：Networks endpoint 需要具有完全访问权限的密钥。控制台成员
            token 需要 `read:networks` 权限。若组织未启用 Networks，也会返回 `code:
            networks_not_entitled`。
          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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            $didit = new DiditClient();


            $result =
            $didit->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`。当
                `cross_org_available` 为 `true` 时为 Null。
              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: 十六进制颜色，例如 `#6366F1`。
        source:
          type: string
          enum:
            - didit
            - custom
          description: Didit 预设标签为 `didit`，您团队创建的标签为 `custom`。
        added_by:
          type: string
          nullable: true
          description: 添加该标签的 Console 成员邮箱。由 API 密钥添加时为 Null。
        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 位小数。设置了 `reason` 时为 null。
        members:
          type: integer
          nullable: true
          description: >-
            评分比对了多少位成员的自拍照。无法读取或背景显示过少的自拍照不会参与比对。在 `computing` 时为 null；在
            `not_enough_selfies` 时为 0 或 1。
        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: 分数计算完成的时间。处于 `computing` 状态时为 null。
    NetworkListItem:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        network_id:
          type: string
          description: 易于阅读的组织内顺序 ID，例如 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: 分数所属的等级：高等级 >= 70，中等级 >= 40，否则为低等级。
        bar:
          type: number
          format: float
          description: 用于渲染风险条的 0-1 归一化值。
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        您的应用 API 密钥，可在 Business Console 的“开发者 -> API
        密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域：针对每个资源设为无权限、只读或读写，限定于特定工作流或已通过的会话、限定于
        IP 地址列表，以及设置到期日期。401 表示密钥错误、已撤销或已过期；403 表示未发送密钥、密钥无权访问该资源或操作，或请求来自其 IP
        列表之外的地址；在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF
        URL 将为 null；没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅
        https://docs.didit.me/console/api-keys。

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.