> ## 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 xarxes de frau > Obtén els punts geogràfics on convergeixen les adreces i ubicacions dels membres d'una xarxa de frau. Documentació de l'API de gestió de Didit. Prompt de l'API del mapa de xarxa Copia el prompt al porta-retalls \

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

\
Enganxa a Recupera els punts geogràfics on convergeixen els membres d'aquesta xarxa, una entrada per cada ubicació observada. `convergence_count` és el nombre de punts diferents que comparteixen diversos membres, útil per detectar una xarxa ancorada en una mateixa adreça o ciutat, fins i tot quan els seus membres, per la resta, no semblen estar relacionats. Això dona suport a la vista de mapa de la xarxa a la Console.## Relacionats- [Obtenir la xarxa](https://docs.didit.me/ca/management-api/networks/get.md) - [Cronologia de la xarxa](https://docs.didit.me/ca/management-api/networks/timeline.md) - [Membres de la xarxa](https://docs.didit.me/ca/management-api/networks/members.md) ## OpenAPI ````yaml ca/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ó d'identitat. Autentica't amb la capçalera 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: Obtenir el mapa de la xarxa description: >- Punts geogràfics on convergeixen les adreces/ubicacions dels membres d'aquesta xarxa, obtinguts a partir de les sessions, sessions d'empresa i transaccions que sustenten les seves afiliacions. operationId: get_network_map parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de l'organització. - name: application_id in: path required: true schema: type: string format: uuid description: UUID de l'aplicació. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID de la xarxa. responses: '200': description: Mapa de la xarxa. content: application/json: schema: $ref: '#/components/schemas/NetworkMap' '404': description: No s'ha trobat la xarxa (o no és visible per a aquesta aplicació). 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: >- Nombre de punts d'adreça/ubicació diferents on convergeixen els membres. 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ístiques agregades de la xarxa (p. ex., totals de membres). fraud_tags: type: array items: type: object description: Etiquetes de patrons de frau detectades a la xarxa. risk_signals: type: object description: >- Resums dels senyals de risc: 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: Nombre de notes privades d'analista en aquesta investigació. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: ID seqüencial per organització llegible per a humans, p. ex. N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Estat del cicle de vida de la xarxa. Distint de l'outcome_status per sol·licitant dins d'una xarxa (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: Els patrons d'agrupament detectats en aquesta xarxa. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Els diferents tipus de senyals presents en aquesta xarxa. member_counts: type: object description: >- Recomptes de membres per categoria (p. ex. total, per outcome_status). member_status: type: object description: Desglossament dels membres per outcome_status. signal_coverage: type: object description: Cobertura dels membres d'aquesta xarxa per 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: Puntuació de risc, 0-100. band: type: string enum: - low - medium - high description: >- Franja en què es representa la puntuació. high >= 70, medium >= 40; altrament, low. bar: type: number format: float description: Valor normalitzat de 0 a 1 per renderitzar una barra de risc. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.