> ## 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. # Netzwerkkarten-API für Betrugsnetzwerke > Ruft geografische Punkte ab, an denen Adressen und Standorte der Mitglieder eines Betrugsnetzwerks zusammenlaufen. Bereitgestellt von Didit. Prompt für die Network-Map-API Prompt in die Zwischenablage kopieren \

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

\
Einfügen in Rufen Sie die geografischen Punkte ab, an denen sich die Mitglieder dieses Netzwerks treffen, mit einem Eintrag pro beobachtetem Standort. `convergence_count` ist die Anzahl unterschiedlicher Punkte, die mehrere Mitglieder gemeinsam haben. Der Wert hilft dabei, ein Netzwerk zu erkennen, das an einer Adresse oder in einer Stadt verankert ist, selbst wenn seine Mitglieder ansonsten unzusammenhängend wirken. Er wird für die Kartenansicht eines Netzwerks in der Console verwendet.## Verwandte Themen- [Netzwerk abrufen](https://docs.didit.me/de/management-api/networks/get.md) - [Netzwerk-Zeitleiste](https://docs.didit.me/de/management-api/networks/timeline.md) - [Netzwerkmitglieder](https://docs.didit.me/de/management-api/networks/members.md) ## OpenAPI ````yaml de/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 für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/map/: get: tags: - Networks summary: Netzwerkkarte abrufen description: >- Geografische Punkte, an denen die Adressen/Standorte der Mitglieder dieses Netzwerks konvergieren, bezogen aus den Sitzungen, Unternehmenssitzungen und Transaktionen, die seinen Mitgliedschaften zugrunde liegen. operationId: get_network_map parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID der Organisation. - name: application_id in: path required: true schema: type: string format: uuid description: Anwendungs-UUID. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: Netzwerk-UUID. responses: '200': description: Netzwerkkarte. content: application/json: schema: $ref: '#/components/schemas/NetworkMap' '404': description: Netzwerk nicht gefunden (oder für diese Anwendung nicht sichtbar). 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: >- Anzahl der eindeutigen Adress-/Standortpunkte, an denen Mitglieder zusammenlaufen. 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: >- Aggregierte Statistiken für das Netzwerk (z. B. Mitglieder-Gesamtzahlen). fraud_tags: type: array items: type: object description: Im Netzwerk erkannte Tags für Betrugsmuster. risk_signals: type: object description: >- Zusammenfassungen von Risikosignalen: 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: Anzahl der privaten Analystennotizen in dieser Untersuchung. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: >- Für Menschen lesbare, fortlaufende ID pro Organisation, z. B. N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Lebenszyklusstatus des Netzwerks. Unterscheidet sich vom antragstellerspezifischen outcome_status innerhalb eines Netzwerks (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: Die in diesem Netzwerk erkannten Clustering-Muster. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: >- Die unterschiedlichen Signaltypen, die in diesem Netzwerk vorhanden sind. member_counts: type: object description: >- Anzahl der Mitglieder nach Kategorie (z. B. insgesamt, pro outcome_status). member_status: type: object description: Aufschlüsselung der Mitglieder nach outcome_status. signal_coverage: type: object description: Abdeckung der Mitglieder dieses Netzwerks pro 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: Risiko-Score, 0-100. band: type: string enum: - low - medium - high description: >- Bereich, in dem der Score dargestellt wird. high >= 70, medium >= 40, andernfalls low. bar: type: number format: float description: Normalisierter Wert von 0–1 zur Darstellung eines Risikobalkens. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.