> ## 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 per API abrufen > Mit der Didit API ein Betrugsnetzwerk abrufen: Statistiken, Betrugs-Tags, Risikosignale, Mitgliedsergebnisse und Selfie-Hintergrund-Score. API-Prompt zum Abrufen eines Netzwerks Prompt in die Zwischenablage kopieren \

\`Retrieve a single fraud network's full detail through the Management API.

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

Authentication:
Use the x-api-key header with my Didit API key.
Networks endpoints need a full-access API key: a key with restricted access gets 403.

Path parameter:
\- network_uuid - the network's UUID, from list networks.

Response 200: NetworkDetailResponse. Everything in the list-item shape (uuid, network_id, name, status, risk, pattern_types, signal_types, member_counts, member_status, signal_coverage, first_activity_at, last_activity_at), plus stats, fraud_tags, risk_signals (residential_proxy_reuse, email_intelligence, phone_intelligence summaries), reviewed_at, reviewed_by, review_reason, notes_count, and:
\- sharing_mode, cross_org_available, cross_org_unavailable_reason: the same fields as on list networks. sharing_mode is off|private|global (only global compares networks across organizations). cross_org_available is true only with the Enterprise plan and global sharing. cross_org_unavailable_reason is plan (checked first), sharing_mode, or null when available.
\- tags: my application's tags on the network, oldest first. Each is {uuid, name, color, source (didit|custom), added_by (the console member's email, or null when an API key added it), added_at}. Each application sees only its own tags. fraud_tags is separate and unchanged: the tags the network's members carry.
\- outcomes: {approved, declined, in_review, total}. Each member I may see counts once, by the status of their most recent verification that reached a decision. total counts members with at least one verification; a member whose verifications are all undecided counts only in total. Transaction parties are not counted.
\- patterns: [{type: "background", score, members, reason, computed_at}]. score is 0 to 1 with 4 decimals: the mean similarity of every pair of member selfie backgrounds, the person masked out. It reads the newest selfie of each person (at most the 50 newest, age assurance sessions excluded) across the whole network, not only my applications.
\- reason "computing": score, members and computed_at are null; read the network again later.
\- reason "not_enough_selfies": fewer than two members have a usable selfie; score is null and members is 0 or 1.
\- reason null: score is set, members is how many selfies were compared, computed_at is when.

Failure modes:
\- 404: {"detail": "Network not found."}. The network does not exist, or has no member visible to this application.
\- 401: missing or invalid x-api-key.
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs read:networks.
\- 403 with {"code": "networks_not_entitled"}: Networks is not enabled for the organization.

Side effects: the network does not change. A read that finds no current background score schedules its computation.

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

\
Einfügen in Rufen Sie ein Netzwerk mit allen Angaben ab, die für das Übersichtsfenster eines Netzwerks benötigt werden: die Risikoaufschlüsselung, erkannte Betrugs-Tags und Zusammenfassungen der Risikosignale, zusätzlich zu den Feldern, die mit der Liste geteilt werden. Die Detailansicht enthält außerdem die Tags Ihrer Anwendung für das Netzwerk, den Stand der Verifizierungen seiner Mitglieder und wie ähnlich sich deren Selfie-Hintergründe sind.## Tags`tags` listet die Tags Ihrer Anwendung für das Netzwerk auf, beginnend mit dem ältesten. Jede Anwendung sieht und ändert nur ihre eigenen Tags. `added_by` ist die E-Mail-Adresse des Konsolenmitglieds, das den Tag hinzugefügt hat, oder `null`, wenn ein API-Schlüssel ihn hinzugefügt hat. Verwenden Sie [Netzwerk-Tag hinzufügen](https://docs.didit.me/de/management-api/networks/add-tag.md) und [Netzwerk-Tag entfernen](https://docs.didit.me/de/management-api/networks/remove-tag.md), um sie zu ändern. `fraud_tags` bleibt unverändert: Es listet die Tags auf, die die Mitglieder des Netzwerks tragen.## Ergebnisse der Mitglieder`outcomes` zählt die Personen und Unternehmen im Netzwerk, die Sie sehen dürfen, wobei jedes davon einmal gezählt wird.| Schlüssel | Was gezählt wird | | - | - | | `approved` | Mitglieder, deren zuletzt entschiedene Verifizierung genehmigt wurde | | `declined` | Mitglieder, deren zuletzt entschiedene Verifizierung abgelehnt wurde | | `in_review` | Mitglieder, deren zuletzt entschiedene Verifizierung in Prüfung ist | | `total` | Mitglieder mit mindestens einer Verifizierung, entschieden oder nicht |Ein Mitglied, das abgelehnt wurde und später bei einem Wiederholungsversuch genehmigt wird, zählt als `approved`. Ein Mitglied, dessen Verifizierungen alle noch nicht entschieden sind (nicht gestartet, in Bearbeitung, abgelaufen oder abgebrochen), zählt nur in `total`. Transaktionsparteien durchlaufen keine Verifizierung und werden nicht gezählt.## Muster des Selfie-Hintergrunds`patterns` enthält derzeit ein Element, bei dem `type` auf `background` gesetzt ist. Sein `score` liegt zwischen 0 und 1 und ist die mittlere Ähnlichkeit aller Paare von Selfie-Hintergründen der Mitglieder, wobei die Person ausgeblendet ist. Ein Score nahe 1 deutet darauf hin, dass die Selfies am selben Ort aufgenommen wurden. Einfarbige Wände in ähnlicher Farbe können ebenfalls einen hohen Score erhalten. Behandeln Sie den Score deshalb als Hinweis für eine Prüfung, nicht als Beweis. Für den Score wird das neueste Selfie jeder Person verwendet, höchstens die 50 neuesten, und Sitzungen zur Altersverifizierung werden ausgelassen. Er umfasst das gesamte Netzwerk, nicht nur die Mitglieder Ihrer Anwendungen.| `reason` | `score` | `members` | Vorgehen | | - | - | - | - | | `null` | 0 bis 1 | Verglichene Selfies | Verwenden Sie den Score. `computed_at` gibt an, wann er berechnet wurde. | | `computing` | `null` | `null` | Der Score für die aktuellen Mitglieder wird berechnet. Rufen Sie das Netzwerk später erneut ab. | | `not_enough_selfies` | `null` | `0` oder `1` | Weniger als zwei Mitglieder haben ein verwendbares Selfie. |Ein Selfie, das nicht gelesen werden kann oder zu wenig Hintergrund zeigt, wird nicht verglichen. Deshalb kann `members` niedriger sein als die Anzahl der Personen im Netzwerk. Der Score beschreibt immer die aktuellen Selfies der Mitglieder. Ändern sie sich, etwa wenn ein Mitglied beitritt oder ein Mitglied das Netzwerk verlässt, meldet die Detailansicht `computing`, bis der neue Score bereit ist, oder `not_enough_selfies`, wenn weniger als zwei übrig bleiben.## Verfügbarkeit organisationsübergreifendDie Detailansicht enthält dieselben Felder `sharing_mode`, `cross_org_available` und `cross_org_unavailable_reason` wie [Netzwerke auflisten](https://docs.didit.me/de/management-api/networks/list.md#freigabemodus-und-organisationsübergreifende-signale). Organisationsübergreifende Signale setzen sowohl den Enterprise-Tarif als auch den Freigabemodus `global` voraus.## Verwandte Seiten- [Netzwerke auflisten](https://docs.didit.me/de/management-api/networks/list.md) - [Netzwerk-Tag hinzufügen](https://docs.didit.me/de/management-api/networks/add-tag.md) - [Netzwerk-Tag entfernen](https://docs.didit.me/de/management-api/networks/remove-tag.md) - [Netzwerkmitglieder](https://docs.didit.me/de/management-api/networks/members.md) - [Netzwerkgraph](https://docs.didit.me/de/management-api/networks/graph.md) ## OpenAPI ````yaml de/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/ 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}/: get: tags: - Networks summary: Netzwerk abrufen description: >- Rufen Sie die vollständigen Details eines einzelnen Netzwerks ab: Statistiken, Betrugs-Tags und Risikosignale sowie den `sharing_mode` der Organisation und die organisationsübergreifende Verfügbarkeit, die `tags` Ihrer Anwendung für das Netzwerk, `outcomes` für Mitglieder und Muster-Scores (`patterns`). Erfordert einen API-Schlüssel mit Vollzugriff oder `read:networks` für ein Console-Mitglied. operationId: get_network 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: Netzwerkdetails. content: application/json: schema: $ref: '#/components/schemas/NetworkDetailResponse' example: uuid: 3fa85f64-5717-4562-b3fc-2c963f66afa6 network_id: N-0042 name: null status: in_review risk: score: 82 band: high bar: 0.82 pattern_types: - exact_same_device - same_email signal_types: - device - email member_counts: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signal_coverage: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 first_activity_at: '2026-10-01T09:12:44Z' last_activity_at: '2026-10-12T16:03:10Z' stats: members: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signals: total: 2 by_type: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 fraud_tags: [] risk_signals: residential_proxy_reuse: detected: false signal_count: 0 max_subject_count: 0 email_intelligence: enriched_signal_count: 1 high_risk_count: 0 social_profile_count: 0 phone_intelligence: enriched_signal_count: 0 high_risk_count: 0 reviewed_at: '2026-10-12T16:30:00Z' reviewed_by: reviewer@example.com review_reason: Shared device across three new accounts. notes_count: 0 sharing_mode: global cross_org_available: true cross_org_unavailable_reason: null tags: - uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 name: SUSPICIOUS color: '#6366F1' source: custom added_by: null added_at: '2026-10-13T08:15:00Z' outcomes: approved: 1 declined: 1 in_review: 0 total: 3 patterns: - type: background score: 0.8125 members: 3 reason: null computed_at: '2026-10-13T08:00:00Z' '401': description: Fehlende oder ungültige Anmeldedaten. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Vorhanden bei codierten Fehlern, zum Beispiel `networks_not_entitled`. examples: Missing or invalid credentials: summary: Fehlende oder ungültige Anmeldedaten value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- Der API-Schlüssel gehört zu einer anderen Anwendung oder ist ein Schlüssel mit eingeschränktem Zugriff: Networks-Endpoints erfordern einen Schlüssel mit Vollzugriff. Ein Konsolen-Mitgliedstoken benötigt `read:networks`. Wird auch mit `code: networks_not_entitled` zurückgegeben, wenn Networks für die Organisation nicht aktiviert ist. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Vorhanden bei codierten Fehlern, zum Beispiel `networks_not_entitled`. examples: Networks not enabled: summary: Netzwerke nicht aktiviert value: detail: >- Networks is disabled for this organization. Contact Didit support if you believe this is an error. code: networks_not_entitled Restricted API key: summary: Eingeschränkter API-Schlüssel value: detail: This API key has no access to this endpoint. No permission: summary: Keine Berechtigung value: detail: You do not have permission to perform this action. '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/' \ -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( "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.retrieve("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.Retrieve(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().retrieve("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieve('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("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.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkDetailResponse: description: >- Die Netzwerkdetails sowie der Freigabemodus der Organisation, ob organisationsübergreifende Signale darauf zutreffen, die Tags Ihrer Anwendung im Netzwerk, Mitgliedsergebnisse und Musterscores. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- Der organisationsübergreifende Freigabemodus der Organisation. Nur `global` vergleicht Netzwerke über Organisationen hinweg; `private` und `off` beschränken sie auf den eigenen Verlauf der Organisation. example: global cross_org_available: type: boolean description: >- Gibt an, ob organisationsübergreifende Signale für diese Organisation gelten. Sie erfordern sowohl den Enterprise-Tarif als auch den Freigabemodus `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Warum organisationsübergreifende Signale nicht greifen, geprüft in dieser Reihenfolge. `plan`: Der Tarif der Organisation enthält das organisationsübergreifende Betrugsnetzwerk nicht (erfordert den Enterprise-Tarif), unabhängig vom Freigabemodus. `sharing_mode`: Der Tarif enthält es, aber der Freigabemodus ist `private` oder `off`. Null, wenn `cross_org_available` `true` ist. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- Die Tags Ihrer Anwendung im Netzwerk, älteste zuerst. Jede Anwendung sieht nur ihre eigenen Tags. `fraud_tags` ist separat und unverändert: die Tags, die die Mitglieder des Netzwerks tragen. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: >- Muster-Scores über das gesamte Netzwerk. Aktuell ein Element, `background`. 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. NetworkTag: type: object description: Einer der Tags Ihrer Anwendung im Netzwerk. properties: uuid: type: string format: uuid description: Die UUID des Tags, derselbe Wert, den Sie als `tag_uuid` übergeben. name: type: string color: type: string description: Hex-Farbe, zum Beispiel `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` für ein von Didit vorgegebenes Tag, `custom` für ein von Ihrem Team erstelltes Tag. added_by: type: string nullable: true description: >- E-Mail des Console-Mitglieds, das den Tag hinzugefügt hat. Null, wenn er über einen API-Schlüssel hinzugefügt wurde. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Status der Personen und Unternehmen des Netzwerks. Jedes Mitglied, das Sie sehen dürfen, zählt einmal, nach dem Status seiner jüngsten Verifizierung, die eine Entscheidung erreicht hat. Transaktionsparteien werden nicht mitgezählt. properties: approved: type: integer description: Mitglieder, deren letzte entschiedene Verifizierung genehmigt wurde. declined: type: integer description: Mitglieder, deren letzte entschiedene Verifizierung abgelehnt wurde. in_review: type: integer description: Mitglieder, deren letzte entschiedene Verifizierung in Prüfung ist. total: type: integer description: >- Mitglieder mit mindestens einer Verifizierung, entschieden oder nicht. Ein Mitglied, dessen Verifizierungen alle unentschieden sind (nicht gestartet, in Bearbeitung, abgelaufen oder abgebrochen), wird hier und in keinem anderen Schlüssel gezählt. NetworkPatternScore: type: object description: >- Wie ähnlich eine Art von Daten der Mitglieder über das gesamte Netzwerk hinweg ist. Ein Muster ist kein Signal: Kein geteilter Wert verknüpft die Mitglieder. properties: type: type: string enum: - background description: >- `background`: die mittlere Ähnlichkeit jedes Paars von Selfie-Hintergründen von Mitgliedern, wobei die Person maskiert ist. Es liest das neueste Selfie jeder Person aus, maximal die 50 neuesten, und lässt Altersüberprüfungssitzungen aus. Es deckt das gesamte Netzwerk ab, nicht nur die Mitglieder Ihrer Anwendungen. score: type: number nullable: true minimum: 0 maximum: 1 description: >- Von 0 bis 1, gerundet auf 4 Dezimalstellen. Null, wenn `reason` gesetzt ist. members: type: integer nullable: true description: >- Wie viele Selfies von Mitgliedern der Score verglichen hat. Ein Selfie, das nicht gelesen werden kann oder zu wenig Hintergrund zeigt, wird nicht verglichen. Null während `computing`; 0 oder 1 bei `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Warum kein Score vorhanden ist. `computing`: Der Score für die aktuellen Mitglieder wird berechnet; lesen Sie das Netzwerk später erneut aus. `not_enough_selfies`: Weniger als zwei Mitglieder haben ein verwendbares Selfie. Null, wenn ein Score vorhanden ist. computed_at: type: string format: date-time nullable: true description: Wann der Score berechnet wurde. Null während `computing`. 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.