> ## 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 Management APIで不正ネットワーク1件の全情報を取得。統計、不正タグ、リスクシグナル、独自タグ、メンバーの結果、セルフィー背景パターンスコア、組織間アクセスを確認できます。



ネットワーク取得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>



      
      

貼り付け先

ネットワークの概要パネルの表示に必要なすべての情報を含むネットワークを1件取得します。一覧と共通のフィールドに加えて、リスクの内訳、検出された不正タグ、リスクシグナルの概要が含まれます。
詳細には、アプリケーションがネットワークに付けたタグ、メンバーの認証の状況、メンバーのセルフィー背景の類似度も含まれます。## タグ`tags`には、ネットワーク上のアプリケーションのタグが古い順に並びます。
各アプリケーションが参照・変更できるのは、自身のタグのみです。
`added_by`は、タグを追加したコンソールメンバーのメールアドレスです。APIキーで追加された場合は`null`になります。
タグを変更するには、[ネットワークタグの追加](https://docs.didit.me/ja/management-api/networks/add-tag.md)と[ネットワークタグの削除](https://docs.didit.me/ja/management-api/networks/remove-tag.md)を使用します。
`fraud_tags`は変わりません。ネットワークのメンバーに付いているタグが並びます。## メンバーの判定結果`outcomes`は、ネットワーク内であなたが参照できる個人と企業の数を、それぞれ1回ずつ数えたものです。| キー | 数える対象 |
| - | - |
| `approved` | 判定済みの最新の認証が承認済みのメンバー |
| `declined` | 判定済みの最新の認証が却下のメンバー |
| `in_review` | 判定済みの最新の認証がレビュー中のメンバー |
| `total` | 判定の有無を問わず、認証が1件以上あるメンバー |却下された後、再試行で承認されたメンバーは`approved`として数えられます。
すべての認証が未判定(未開始、進行中、期限切れ、放棄)のメンバーは、`total`にのみ数えられます。
取引の当事者は認証を受けないため、数に含まれません。## セルフィー背景のパターン現在、`patterns`には`type`が`background`の項目が1件含まれます。
その`score`は0〜1の値で、人物部分をマスクしたうえで、メンバーのセルフィー背景のすべての組み合わせについて算出した類似度の平均です。
スコアが1に近い場合、セルフィーが同じ場所で撮影された可能性があります。
似た色の無地の壁でもスコアが高くなることがあるため、スコアは証明ではなく、レビューのための根拠として扱ってください。
スコアには各人物の最新のセルフィーを使用し、対象は新しいものから最大50件です。年齢確認セッションは除外されます。
スコアはあなたのアプリケーションのメンバーだけでなく、ネットワーク全体を対象とします。| `reason` | `score` | `members` | 対応 |
| - | - | - | - |
| `null` | 0〜1 | 比較したセルフィーの数 | スコアを使用します。`computed_at`は算出日時を示します。 |
| `computing` | `null` | `null` | 現在のメンバーのスコアを算出中です。後でネットワークを再度取得してください。 |
| `not_enough_selfies` | `null` | `0`または`1` | 使用可能なセルフィーがあるメンバーが2人未満です。 |読み取れないセルフィーや背景の写りが少なすぎるセルフィーは比較されないため、`members`がネットワーク内の人数より少なくなることがあります。
スコアは常に現在のメンバーのセルフィーを表します。
メンバーの参加や離脱などでセルフィーが変わると、新しいスコアが算出されるまで詳細は`computing`を返します。残りが2人未満の場合は`not_enough_selfies`を返します。## 組織横断での利用可否詳細には、[ネットワーク一覧の取得](https://docs.didit.me/ja/management-api/networks/list.md#共有モードと組織横断シグナル)と同じ`sharing_mode`、`cross_org_available`、`cross_org_unavailable_reason`が含まれます。
組織横断のシグナルを利用するには、Enterpriseプランと`global`共有モードの両方が必要です。## 関連項目- [ネットワーク一覧の取得](https://docs.didit.me/ja/management-api/networks/list.md)
- [ネットワークタグの追加](https://docs.didit.me/ja/management-api/networks/add-tag.md)
- [ネットワークタグの削除](https://docs.didit.me/ja/management-api/networks/remove-tag.md)
- [ネットワークメンバー](https://docs.didit.me/ja/management-api/networks/members.md)
- [ネットワークグラフ](https://docs.didit.me/ja/management-api/networks/graph.md)


## OpenAPI

````yaml ja/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: >-
        1つのネットワークの詳細情報を取得します。統計、不正タグとリスクシグナルに加え、組織の`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キーが別のアプリケーションに属しているか、アクセスが制限されたキーです。ネットワークのエンドポイントにはフルアクセスキーが必要です。コンソールメンバーのトークンには`read: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`の1項目です。
    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: ネットワーク上のアプリケーションのタグのいずれか1つです。
      properties:
        uuid:
          type: string
          format: uuid
          description: タグのUUID。`tag_uuid`として渡す値と同じです。
        name:
          type: string
        color:
          type: string
          description: '16進カラーコードです。例: `#6366F1`。'
        source:
          type: string
          enum:
            - didit
            - custom
          description: Diditのプリセットタグの場合は`didit`、チームが作成したタグの場合は`custom`。
        added_by:
          type: string
          nullable: true
          description: タグを追加したコンソールメンバーのメールアドレス。APIキーで追加された場合はnull。
        added_at:
          type: string
          format: date-time
    NetworkOutcomes:
      type: object
      description: >-
        ネットワーク内の個人と企業の状況です。閲覧可能な各メンバーは、判定に至った最新の検証のステータスに基づいて1回ずつカウントされます。取引の当事者はカウントされません。
      properties:
        approved:
          type: integer
          description: 直近の判定済みの認証が承認済みのメンバーです。
        declined:
          type: integer
          description: 直近の判定済みの認証が却下されたメンバーです。
        in_review:
          type: integer
          description: 直近の判定済みの認証がレビュー中のメンバーです。
        total:
          type: integer
          description: >-
            判定済みかどうかにかかわらず、1件以上の認証があるメンバーです。すべての認証が未判定（未開始、進行中、期限切れ、または放棄）のメンバーはここでカウントされ、他のキーではカウントされません。
    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`：使用可能なセルフィーを持つメンバーが2人未満です。スコアがある場合は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以上はhigh、40以上はmedium、それ以外はlow。
        bar:
          type: number
          format: float
          description: リスクバーの描画に使う0-1の正規化された値。
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API
        keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください:
        https://docs.didit.me/console/api-keys

````

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