> ## 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 > Obtenha com a API da Didit os pontos geográficos onde convergem os endereços e localizações dos membros de uma rede de fraude. Prompt da API de mapa da rede Copiar o prompt para a área de transferência \

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

\
Colar em Obtenha os pontos geográficos onde os membros desta rede convergem, com uma entrada por local observado. `convergence_count` é o número de pontos distintos compartilhados por vários membros, útil para identificar uma rede ancorada em um único endereço ou cidade, mesmo quando seus membros parecem não ter relação entre si. Isso dá suporte à visualização de mapa de uma rede no Console.## Relacionados- [Obter rede](https://docs.didit.me/pt-br/management-api/networks/get.md) - [Linha do tempo da rede](https://docs.didit.me/pt-br/management-api/networks/timeline.md) - [Membros da rede](https://docs.didit.me/pt-br/management-api/networks/members.md) ## OpenAPI ````yaml pt-br/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 verificação de identidade. Autentique-se com o cabeçalho 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: Obter o mapa da rede description: >- Pontos geográficos onde convergem os endereços/localizações dos membros desta rede, obtidos das sessões, sessões de empresa e transações que sustentam suas associações. operationId: get_network_map parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID da organização. - name: application_id in: path required: true schema: type: string format: uuid description: UUID da aplicação. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID da rede. responses: '200': description: Mapa da rede. content: application/json: schema: $ref: '#/components/schemas/NetworkMap' '404': description: Rede não encontrada (ou não visível para esta aplicação). 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: >- 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 pontos distintos de endereço/localização em que os membros convergem. 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: Estatísticas agregadas da rede (por exemplo, totais de membros). fraud_tags: type: array items: type: object description: Tags de padrões de fraude identificadas na rede. risk_signals: type: object description: >- Resumos dos sinais de risco: 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 nesta investigação. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: ID sequencial legível por organização, por exemplo N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Status do ciclo de vida da rede. Diferente do outcome_status por candidato dentro de uma rede (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: Os padrões de agrupamento detectados nesta rede. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Os tipos de sinal distintos presentes nesta rede. member_counts: type: object description: >- Contagens de membros por categoria (por exemplo, total, por outcome_status). member_status: type: object description: Distribuição dos membros por outcome_status. signal_coverage: type: object description: Cobertura por signal_type dos membros desta rede. 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: Pontuação de risco, de 0 a 100. band: type: string enum: - low - medium - high description: >- Faixa em que a pontuação é exibida. high >= 70, medium >= 40, caso contrário low. bar: type: number format: float description: Valor normalizado de 0 a 1 para renderizar uma barra de risco. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.