> ## 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. # Betrugsnetzwerk-Graph-API > Ruft mit Didit ein Betrugsnetzwerk als Graph aus Subjekt- und Signal-Knoten ab. depth begrenzt die Nachbarschaft eines Fokus-Subjekts. Prompt für die Network-Graph-API Prompt in die Zwischenablage kopieren \

\`Retrieve a fraud network as a graph through the Management API.

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

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

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

Query params:
\- depth=1|2|3|all - hops from the focus subject to include. Defaults to all (unbounded).
\- focus_kind=vendor_user|vendor_business|transaction_party - must be supplied together with focus_id.
\- focus_id= - subject UUID to center the graph on.

Response 200: NetworkGraph - { network: NetworkDetail, depth: int|null, truncated: bool, nodes: [...], edges: [...], metrics: {node_count, edge_count, hub_signal_count} }.

Node shapes:
\- Subject node (kind: vendor_user | vendor_business | transaction_party): id, kind, subject, node_status (approved|in_review|declined|not_completed), tags.
\- Signal node (kind: signal): id, kind, uuid, signal_type, subject_count, coverage, is_hub, is_datacenter_ip, is_high_collision_device, node_status (signal_active|signal_guarded), tags, risk_evidence, first_seen_at, last_seen_at.

Edge shape: id, source (subject node id), target (signal node id), subject_kind, signal_type, confidence, observation_count, first_seen_at, last_seen_at.

Failure modes:
\- 404 - network not found or not visible.
\- 400 - depth is not one of 1, 2, 3, all, or focus_kind/focus_id supplied without the other.
\- 401/403 - auth/permission errors.

Side effects: none, pure read.

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

\
Einfügen in Rufen Sie das Netzwerk als Graphen ab: Subjekt-Knoten für jeden Benutzer des Vendors, jedes Unternehmen des Vendors oder jede Transaktionspartei im Netzwerk, Signal-Knoten für jedes gemeinsam genutzte Gerät, jede gemeinsame Adresse, jedes gemeinsame Gesicht, jede gemeinsame Dokumentnummer, Telefonnummer, E-Mail-Adresse oder sonstige Adresse, die sie miteinander verbindet, und Kanten für die Mitgliedschaften zwischen ihnen.Verwenden Sie `depth`, um zu begrenzen, wie viele Sprünge von einem durch `focus_kind`/`focus_id` bestimmten Subjekt aus zurückgegeben werden. Damit wird die Graphansicht der Console unterstützt, die beim Zoomen auf die unmittelbaren Verbindungen eines Antragstellers nicht das gesamte Netzwerk laden muss. Lassen Sie `depth` weg (oder übergeben Sie `all`), um die vollständige Nachbarschaft zu erhalten. `truncated` zeigt an, ob eine begrenzte Anfrage etwas abgeschnitten hat.## Verwandte Inhalte- [Netzwerk abrufen](https://docs.didit.me/de/management-api/networks/get.md) - [Netzwerkmitglieder](https://docs.didit.me/de/management-api/networks/members.md) - [Netzwerksignale](https://docs.didit.me/de/management-api/networks/signals.md) ## OpenAPI ````yaml de/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/ 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}/graph/: get: tags: - Networks summary: Netzwerkgraphen abrufen description: >- Das Netzwerk als Graph aus Subjektknoten (Anbieterbenutzer, Anbieterunternehmen, Transaktionsparteien) und Signalknoten (die geteilten Geräte-/IP-/Gesichts-/Dokument-/Telefon-/E-Mail-/Adresswerte, die sie verbinden) abrufen, mit Kanten, die Zugehörigkeiten darstellen. operationId: get_network_graph 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. - name: depth in: query schema: type: string enum: - '1' - '2' - '3' - all description: >- Einzubeziehende Hops ausgehend vom Fokusobjekt. Standardmäßig alle (unbegrenzt). - name: focus_kind in: query schema: type: string enum: - vendor_user - vendor_business - transaction_party description: >- Subjekttyp, auf den der Graph zentriert werden soll. Muss zusammen mit focus_id angegeben werden; standardmäßig ein beliebiges Mitglied, wenn die Tiefe begrenzt ist und keines von beiden angegeben wird. - name: focus_id in: query schema: type: string format: uuid description: Subjekt-UUID, auf die der Graph zentriert werden soll. responses: '200': description: Netzwerk-Graph. content: application/json: schema: $ref: '#/components/schemas/NetworkGraph' '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/graph/?depth=2' \ -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_graph( "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.retrieveGraph("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.RetrieveGraph(ctx, \"n3a5e000-0000-4000-8000-000000000001\", didit.NetworksRetrieveGraphParams{})\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().retrieveGraph("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieveGraph('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_graph("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.RetrieveGraphAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkGraph: type: object properties: network: $ref: '#/components/schemas/NetworkDetail' depth: type: integer nullable: true description: Angewendete effektive Tiefe oder null, wenn unbegrenzt (depth=all). truncated: type: boolean description: True, wenn die Nachbarschaft aufgrund der Tiefe abgeschnitten wurde. nodes: type: array items: $ref: '#/components/schemas/NetworkGraphNode' edges: type: array items: $ref: '#/components/schemas/NetworkGraphEdge' metrics: type: object properties: node_count: type: integer edge_count: type: integer hub_signal_count: type: integer 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. NetworkGraphNode: type: object description: >- Ein Subjekt-Knoten oder ein Signal-Knoten, unterschieden nach Typ. Subjekt-Knoten (kind: vendor_user | vendor_business | transaction_party) enthalten id, kind, subject, node_status (approved | in_review | declined | not_completed) und tags. Signal-Knoten (kind: signal) enthalten id, kind, uuid, signal_type, subject_count, coverage, is_hub, is_datacenter_ip, is_high_collision_device, node_status (signal_active | signal_guarded), tags, risk_evidence, first_seen_at und last_seen_at. properties: id: type: string kind: type: string enum: - vendor_user - vendor_business - transaction_party - signal NetworkGraphEdge: type: object properties: id: type: string format: uuid source: type: string description: Subjekt-Knoten-ID. target: type: string description: Signal-Knoten-ID. subject_kind: type: string enum: - vendor_user - vendor_business - transaction_party signal_type: type: string enum: - ip_address - device - face - document_number - phone - email - address confidence: type: number format: float description: 1.0 für eine exakte Übereinstimmung. observation_count: type: integer first_seen_at: type: string format: date-time nullable: true last_seen_at: type: string format: date-time nullable: true 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.