> ## 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>

\`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,<member email>,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.`

\</pre>



      
      

붙여넣을 곳

조직에서 탐지된 사기 네트워크를 나열합니다.
기본적으로 목록은 위험 점수가 높은 순서로 정렬되며, 점수가 같으면 최근 활동이 최신인 순서로 정렬됩니다.
콘솔의 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 요금제가 필요합니다). 요금제에는 포함되지만 공유 모드가 `private` 또는 `off`이면 `sharing_mode`입니다. `cross_org_available`이 `true`이면 `null`입니다. |요금제를 먼저 확인합니다. Enterprise 요금제보다 낮은 경우, 공유 모드가 `global`이어도 이유는 `plan`입니다.## 개수와 summary 파라미터`kpis`는 필터와 일치하는 네트워크를 집계하고, `counts`는 애플리케이션이 볼 수 있는 모든 네트워크를 집계합니다. 따라서 두 값 모두 페이지 자체보다 비용이 더 많이 듭니다.
페이지와 `count`만 필요하면 `summary=false`를 전달하십시오. 이 경우 응답에서 `kpis`와 `counts`가 생략됩니다.
`summary`는 `true` 또는 `false`만 허용하며, 다른 값은 `400`을 반환합니다.`counts`에는 목록의 보기와 필터 옵션에 해당하는 숫자가 들어 있으며, 각 네트워크는 한 번만 집계됩니다.| 키 | 집계 대상 |
| - | - |
| `scopes` | 볼 수 있는 모든 네트워크(`all`)를 `transactions`(모든 멤버가 거래 당사자인 네트워크)와 `identity`(그 밖의 모든 네트워크)로 나눈 수입니다. |
| `views` | 선택한 `scope`(`all`) 안에서 볼 수 있는 네트워크를 상태별(`active`, `in_review`, `resolved`, `dismissed`), 호출한 콘솔 멤버에게 할당된 네트워크(`mine`), 그리고 `high_risk`(위험 점수 80 이상이며 dismissed 상태가 아닌 네트워크)로 집계합니다. |
| `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`를 변경하지 않습니다.
API 키의 경우 콘솔 멤버가 호출하지 않으므로 `views.mine`과 `facets.assignee.me`는 항상 `0`입니다.## 접근 권한Networks endpoint에는 전체 접근 권한이 있는 [API 키](https://docs.didit.me/ko/console/api-keys.md)가 필요합니다.
제한된 접근 권한을 가진 키는 `403`을 받습니다.
콘솔 멤버 토큰에는 `list:networks`가 필요합니다.
조직에서 Networks가 활성화되지 않으면 모든 Networks endpoint가 `"code": "networks_not_entitled"`와 함께 `403`을 반환합니다.## 관련 항목- [네트워크 조회](https://docs.didit.me/ko/management-api/networks/get.md)
- [네트워크 그래프](https://docs.didit.me/ko/management-api/networks/graph.md)
- [네트워크(콘솔)](https://docs.didit.me/ko/console/networks.md)


## OpenAPI

````yaml ko/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: >-
        이 애플리케이션의 조직 내에서 감지된 사기 네트워크를 기본적으로 위험 수준이 가장 높은 순서대로 나열합니다. 기본적으로 기각된
        네트워크는 제외되며, 이를 포함하려면 status를 전달합니다. 샌드박스 데이터는 클러스터링에서 완전히 제외되므로 샌드박스
        애플리케이션에는 네트워크가 존재하지 않습니다. 모든 응답에는 조직의 `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`, 멤버 이메일(대소문자 구분 없이 일치) 또는 호출한 콘솔 멤버를 나타내는
            `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:
            <values>."}`을 반환합니다.
        - 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: 첫 번째 레코드의 0부터 시작하는 오프셋입니다.
        - name: summary
          in: query
          schema:
            type: boolean
            default: true
          description: >-
            `false`는 `kpis` 및 `counts` 없이 페이지와 해당 `count`만 반환합니다. 기본값은
            `true`입니다. `true` 또는 `false` 이외의 값은 400을 반환합니다.
      responses:
        '200':
          description: >-
            조직의 공유 모드 및 조직 간 가용성을 포함하는 페이지 단위로 제공되는 네트워크 목록이며, `summary=false`가
            아닌 경우 `kpis` 및 `counts`도 함께 제공됩니다.
          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: >-
                      조직 간 신호가 이 조직에 적용되는지 여부입니다. 엔터프라이즈 플랜과 `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
                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: 유효하지 않은 범위
                  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 키가 다른 애플리케이션에 속해 있거나 접근 권한이 제한된 키입니다. Networks 엔드포인트에는 전체 접근 권한
            키가 필요합니다. 콘솔 멤버 토큰에는 `list: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.
      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: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
            // and DIDIT_APPLICATION_ID.
            $didit = new DiditClient();

            foreach ($didit->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: '사람이 읽을 수 있는 조직별 순차 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
    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: 호출하는 콘솔 멤버에게 할당된 네트워크입니다. API 키의 경우 항상 0입니다.
            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: 호출한 콘솔 멤버에게 할당되었습니다. API 키의 경우 항상 0입니다.
                unassigned:
                  type: integer
                  description: 아무에게도 할당되지 않았습니다.
                users:
                  type: array
                  description: 담당자당 항목 1개(네트워크 수가 가장 많은 순서로 정렬)입니다.
                  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: 점수가 표시되는 구간입니다. 70 이상은 high, 40 이상은 medium, 그 외에는 low입니다.
        bar:
          type: number
          format: float
          description: 위험 바를 렌더링하기 위한 정규화된 0-1 값입니다.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본
        키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며
        특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나
        만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된
        IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를
        벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write
        권한이 없는 키는 세션 링크와 token을 null로 수신합니다.
        https://docs.didit.me/console/api-keys 를 참고하십시오.

````

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