> ## 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 Peta Jaringan Penipuan

> Melalui Didit, Anda dapat mengambil titik-titik geografis tempat alamat dan lokasi para anggota jaringan penipuan berkumpul.



Prompt API Peta Jaringan
        Salin prompt ke papan klip



      
      

\<pre>

\`Retrieve a fraud network's geographic footprint through the Management API.

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

Authentication:
Use the x-api-key header with my Didit API key.

Path parameter:
\- network_uuid - the network's UUID.

Response 200: NetworkMap - { network: NetworkDetail, convergence_count: int, countries: [string, ...], points: [{uuid, country, country_code, city, latitude, longitude, observed_at}, ...] }.
Points are sourced from the sessions, business sessions, and transactions backing the network's memberships (IP geolocation and proof-of-address data).

Failure modes:
\- 404 - network not found or not visible.
\- 401/403 - auth/permission errors.

Side effects: none, pure read.

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

\</pre>



      
      

Tempel ke

Ambil titik geografis tempat anggota jaringan ini berkumpul, dengan satu entri untuk setiap lokasi yang teramati. `convergence_count` adalah jumlah titik berbeda tempat beberapa anggota berkumpul. Nilai ini berguna untuk mengenali jaringan yang berpusat pada satu alamat atau kota, meskipun anggotanya tampak tidak berkaitan. Data ini mendukung tampilan peta jaringan di Console.## Terkait- [Dapatkan jaringan](https://docs.didit.me/id/management-api/networks/get.md)
- [Linimasa jaringan](https://docs.didit.me/id/management-api/networks/timeline.md)
- [Anggota jaringan](https://docs.didit.me/id/management-api/networks/members.md)


## OpenAPI

````yaml id/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/map/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/map/:
    get:
      tags:
        - Networks
      summary: Dapatkan peta jaringan
      description: >-
        Titik geografis tempat alamat/lokasi anggota jaringan ini bertemu,
        bersumber dari sesi, sesi bisnis, dan transaksi yang mendukung
        keanggotaannya.
      operationId: get_network_map
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID organisasi.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID aplikasi.
        - name: network_uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            example: n3a5e000-0000-4000-8000-000000000001
          description: UUID jaringan.
      responses:
        '200':
          description: Peta jaringan.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkMap'
        '404':
          description: Jaringan tidak ditemukan (atau tidak terlihat oleh aplikasi ini).
          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/map/'
            \
              -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_map(
                "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.retrieveMap("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.RetrieveMap(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().retrieveMap("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->retrieveMap('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_map("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.RetrieveMapAsync("n3a5e000-0000-4000-8000-000000000001");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    NetworkMap:
      type: object
      properties:
        network:
          $ref: '#/components/schemas/NetworkDetail'
        convergence_count:
          type: integer
          description: >-
            Jumlah titik alamat/lokasi berbeda yang menjadi tempat berkumpulnya
            para anggota.
        countries:
          type: array
          items:
            type: string
        points:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              country:
                type: string
                nullable: true
              country_code:
                type: string
                nullable: true
              city:
                type: string
                nullable: true
              latitude:
                type: number
                format: float
                nullable: true
              longitude:
                type: number
                format: float
                nullable: true
              observed_at:
                type: string
                format: date-time
                nullable: true
    NetworkDetail:
      allOf:
        - $ref: '#/components/schemas/NetworkListItem'
        - type: object
          properties:
            stats:
              type: object
              description: Statistik agregat untuk jaringan (misalnya total anggota).
            fraud_tags:
              type: array
              items:
                type: object
              description: Tag pola penipuan yang muncul di jaringan.
            risk_signals:
              type: object
              description: >-
                Ringkasan sinyal risiko: 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: Jumlah catatan analis privat dalam investigasi ini.
    NetworkListItem:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        network_id:
          type: string
          description: >-
            ID berurutan per organisasi yang dapat dibaca manusia, misalnya
            N-0001.
        name:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - active
            - in_review
            - resolved
            - dismissed
          description: >-
            Status siklus hidup jaringan. Berbeda dari outcome_status per
            pemohon di dalam jaringan
            (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: Pola pengelompokan yang terdeteksi di jaringan ini.
        signal_types:
          type: array
          items:
            type: string
            enum:
              - ip_address
              - device
              - face
              - document_number
              - phone
              - email
              - address
          description: Jenis sinyal berbeda yang ada di jaringan ini.
        member_counts:
          type: object
          description: >-
            Jumlah anggota berdasarkan kategori (misalnya total, per
            outcome_status).
        member_status:
          type: object
          description: Rincian anggota berdasarkan outcome_status.
        signal_coverage:
          type: object
          description: Cakupan per signal_type dari anggota jaringan ini.
        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: Skor risiko, 0-100.
        band:
          type: string
          enum:
            - low
            - medium
            - high
          description: Rentang tampilan skor. high >= 70, medium >= 40, selain itu low.
        bar:
          type: number
          format: float
          description: Nilai 0-1 yang dinormalisasi untuk menampilkan bilah risiko.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi
        cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa
        alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan
        pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses
        media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa
        izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat
        https://docs.didit.me/console/api-keys.

````

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