> ## 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 de mapa de redes de fraude

> Didit obtiene los puntos geográficos donde convergen las direcciones y ubicaciones de los miembros de una red de fraude.



Prompt de la API de mapa de red
        Copiar el prompt al portapapeles



      
      

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



      
      

Pegar en

Obtén los puntos geográficos en los que convergen los miembros de esta red, con una entrada por cada ubicación observada. `convergence_count` es el número de puntos distintos que comparten varios miembros, y sirve para detectar una red anclada en una misma dirección o ciudad aunque, por lo demás, sus miembros parezcan no estar relacionados. Esto sirve de base para la vista de mapa de una red en la Console.## Relacionado- [Obtener red](https://docs.didit.me/es/management-api/networks/get.md)
- [Cronología de la red](https://docs.didit.me/es/management-api/networks/timeline.md)
- [Miembros de la red](https://docs.didit.me/es/management-api/networks/members.md)


## OpenAPI

````yaml es/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 de verificación de identidad. Autentícate con el encabezado 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: Obtener el mapa de la red
      description: >-
        Puntos geográficos en los que convergen las direcciones o ubicaciones de
        los miembros de esta red, obtenidos de las sesiones, las sesiones de
        empresa y las transacciones que respaldan sus membresías.
      operationId: get_network_map
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID de la organización.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID de la aplicación.
        - name: network_uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            example: n3a5e000-0000-4000-8000-000000000001
          description: UUID de la red.
      responses:
        '200':
          description: Mapa de la red.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkMap'
        '404':
          description: Red no encontrada (o no visible para esta aplicación).
          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: >-
            Número de puntos de dirección o ubicación distintos en los que
            coinciden los miembros.
        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: Estadísticas agregadas de la red (p. ej., totales de miembros).
            fraud_tags:
              type: array
              items:
                type: object
              description: Etiquetas de patrones de fraude detectadas en la red.
            risk_signals:
              type: object
              description: >-
                Resúmenes de señales de riesgo: 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: Número de notas privadas de analistas en esta investigación.
    NetworkListItem:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        network_id:
          type: string
          description: ID secuencial legible por organización, p. ej. N-0001.
        name:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - active
            - in_review
            - resolved
            - dismissed
          description: >-
            Estado del ciclo de vida de la red. Es distinto del outcome_status
            de cada solicitante dentro de una red
            (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: Los patrones de agrupamiento detectados en esta red.
        signal_types:
          type: array
          items:
            type: string
            enum:
              - ip_address
              - device
              - face
              - document_number
              - phone
              - email
              - address
          description: Los distintos tipos de señal presentes en esta red.
        member_counts:
          type: object
          description: >-
            Recuentos de miembros por categoría (p. ej., total, por
            outcome_status).
        member_status:
          type: object
          description: Desglose de los miembros por outcome_status.
        signal_coverage:
          type: object
          description: Cobertura por signal_type de los miembros de esta red.
        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: Puntuación de riesgo, de 0 a 100.
        band:
          type: string
          enum:
            - low
            - medium
            - high
          description: >-
            Banda con la que se muestra la puntuación. high >= 70, medium >= 40;
            en otro caso, low.
        bar:
          type: number
          format: float
          description: Valor normalizado de 0 a 1 para representar una barra de riesgo.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clave de API de tu aplicación, que encontrarás en Developers -> API
        keys en la Business Console. La clave principal tiene acceso completo.
        Una clave con nombre puede tener un alcance limitado: ninguno, lectura o
        escritura por recurso, limitada a algunos flujos o a sesiones aprobadas,
        a una lista de direcciones IP y a una fecha de caducidad. 401 significa
        que la clave es incorrecta, se revocó o expiró; 403 significa que no se
        envió ninguna clave, que la clave no tiene acceso a este recurso o
        acción, o que la solicitud provino de una dirección fuera de su lista de
        IP; 404 en una ruta de sesión significa que la sesión está fuera de los
        flujos o estados de la clave. Una clave sin acceso a contenido
        multimedia recibe las URL de imágenes, videos y PDF como null, y una
        clave sin permiso de escritura en sesiones recibe los enlaces y tokens
        de sesión como null. Consulta https://docs.didit.me/console/api-keys.

````

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