> ## 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. # Rete di frodi API: ottieni i dettagli > Recupera una rete di frodi in Didit: statistiche, tag, segnali di rischio, esiti dei membri, punteggio sfondo selfie e accesso cross-organizzazione. Prompt API per recuperare una rete Copia il prompt negli appunti \

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

\
Incolla in Recupera una singola rete con tutto ciò che serve per mostrare il pannello di panoramica della rete: la suddivisione del rischio, i tag di frode rilevati e i riepiloghi dei segnali di rischio, oltre ai campi condivisi con la lista. Il dettaglio riporta anche i tag della tua applicazione sulla rete, lo stato delle verifiche dei suoi membri, e quanto sono simili tra loro gli sfondi dei loro selfie.## Tag`tags` elenca i tag della tua applicazione sulla rete, dal più vecchio al più recente. Ogni applicazione vede e modifica solo i propri tag. `added_by` è l'email del membro della console che ha aggiunto il tag, oppure `null` se il tag è stato aggiunto tramite una chiave API. Usa [Aggiungi tag alla rete](https://docs.didit.me/it/management-api/networks/add-tag.md) e [Rimuovi tag dalla rete](https://docs.didit.me/it/management-api/networks/remove-tag.md) per modificarli. `fraud_tags` non cambia: elenca i tag che i membri della rete hanno.## Esiti dei membri`outcomes` conta le persone e le aziende della rete che puoi vedere, ognuna contata una sola volta.| Chiave | Cosa conta | | - | - | | `approved` | Membri la cui verifica più recente con decisione è stata approvata | | `declined` | Membri la cui verifica più recente con decisione è stata rifiutata | | `in_review` | Membri la cui verifica più recente con decisione è in revisione | | `total` | Membri con almeno una verifica, con decisione o meno |Un membro rifiutato e poi approvato dopo un nuovo tentativo conta come `approved`. Un membro le cui verifiche sono tutte senza decisione (non avviate, in corso, scadute o abbandonate) conta solo in `total`. Le parti di una transazione non passano attraverso alcuna verifica e non vengono conteggiate.## Schema dello sfondo dei selfie`patterns` contiene al momento un solo elemento, con `type` impostato su `background`. Il suo `score`, da 0 a 1, è la similarità media tra tutte le coppie di sfondi dei selfie dei membri, con la persona mascherata. Un punteggio vicino a 1 suggerisce che i selfie siano stati scattati nello stesso luogo. Anche pareti semplici di colore simile possono ottenere un punteggio alto, quindi considera il punteggio come un elemento a supporto di una revisione, non come una prova. Il punteggio considera il selfie più recente di ciascuna persona, per un massimo di 50 selfie tra i più recenti, ed esclude le sessioni di verifica dell'età. Copre l'intera rete, non solo i membri delle tue applicazioni.| `reason` | `score` | `members` | Cosa fare | | - | - | - | - | | `null` | da 0 a 1 | Selfie confrontati | Usa il punteggio. `computed_at` indica quando è stato calcolato. | | `computing` | `null` | `null` | Il punteggio per i membri attuali è in calcolo. Leggi di nuovo la rete più tardi. | | `not_enough_selfies` | `null` | `0` o `1` | Meno di due membri hanno un selfie utilizzabile. |Un selfie che non può essere letto, o che mostra troppo poco sfondo, non viene confrontato, quindi `members` può essere inferiore al numero di persone nella rete. Il punteggio descrive sempre i selfie attuali dei membri. Quando cambiano, per esempio quando un membro entra o esce, il dettaglio riporta `computing` finché il nuovo punteggio non è pronto, oppure `not_enough_selfies` quando ne restano meno di due.## Disponibilità tra organizzazioniIl dettaglio riporta gli stessi `sharing_mode`, `cross_org_available` e `cross_org_unavailable_reason` riportati in [Elenca le reti](https://docs.didit.me/it/management-api/networks/list.md#modalità-di-condivisione-e-segnali-tra-organizzazioni). I segnali tra organizzazioni richiedono sia il piano Enterprise sia la modalità di condivisione `global`.## Correlati- [Elenca le reti](https://docs.didit.me/it/management-api/networks/list.md) - [Aggiungi tag alla rete](https://docs.didit.me/it/management-api/networks/add-tag.md) - [Rimuovi tag dalla rete](https://docs.didit.me/it/management-api/networks/remove-tag.md) - [Membri della rete](https://docs.didit.me/it/management-api/networks/members.md) - [Grafo della rete](https://docs.didit.me/it/management-api/networks/graph.md) ## OpenAPI ````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/: get: tags: - Networks summary: Recupera rete description: >- Recupera i dettagli completi di una singola rete: statistiche, tag di frode e segnali di rischio, oltre a `sharing_mode` e alla disponibilità tra organizzazioni per l'organizzazione, i `tags` della tua applicazione sulla rete, gli esiti (`outcomes`) dei membri e i punteggi dei pattern (`patterns`). Richiede una chiave API con accesso completo, oppure `read:networks` per un membro della console. operationId: get_network parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID dell'organizzazione. - name: application_id in: path required: true schema: type: string format: uuid description: UUID dell'applicazione. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID della rete. responses: '200': description: Dettaglio della rete. 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: Credenziali mancanti o non valide. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente sugli errori codificati, ad esempio `networks_not_entitled`. examples: Missing or invalid credentials: summary: Credenziali mancanti o non valide value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- La chiave API appartiene a un'altra applicazione, oppure è una chiave con accesso limitato: gli endpoint Networks richiedono una chiave con accesso completo. Un token di un membro della console richiede `read:networks`. Viene restituito anche con `code: networks_not_entitled` quando Networks non è abilitato per l'organizzazione. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente sugli errori codificati, ad esempio `networks_not_entitled`. examples: Networks not enabled: summary: Reti non abilitate 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: Chiave API con restrizioni value: detail: This API key has no access to this endpoint. No permission: summary: Nessuna autorizzazione value: detail: You do not have permission to perform this action. '404': description: Rete non trovata (o non visibile per questa applicazione). 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: >- I dettagli della rete, oltre alla modalità di condivisione dell'organizzazione, all'eventuale applicazione di segnali tra organizzazioni, ai tag della tua applicazione sulla rete, agli esiti dei membri e ai punteggi dei pattern. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- La modalità di condivisione tra organizzazioni dell'organizzazione. Solo `global` confronta le reti tra organizzazioni; `private` e `off` le limitano alla cronologia interna dell'organizzazione. example: global cross_org_available: type: boolean description: >- Indica se i segnali tra organizzazioni si applicano a questa organizzazione. Richiedono sia il piano Enterprise sia la modalità di condivisione `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Il motivo per cui i segnali inter-organizzazione non sono applicabili, verificati in questo ordine. `plan`: il piano dell'organizzazione non include la rete antifrode inter-organizzazione (richiede il piano Enterprise), indipendentemente dalla modalità di condivisione. `sharing_mode`: il piano la include, ma la modalità di condivisione è `private` o `off`. Null quando `cross_org_available` è `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- I tag della tua applicazione sulla rete, dal meno recente al più recente. Ciascuna applicazione visualizza solo i propri tag. `fraud_tags` è separato e invariato: i tag associati ai membri della rete. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: >- Punteggi dei pattern sull'intera rete. Attualmente un elemento, `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: Statistiche aggregate per la rete (ad es. totali dei membri). fraud_tags: type: array items: type: object description: Tag dei pattern di frode rilevati sulla rete. risk_signals: type: object description: >- Riepiloghi dei segnali di rischio: 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: Numero di note private dell'analista in questa indagine. NetworkTag: type: object description: Uno dei tag della tua applicazione sulla rete. properties: uuid: type: string format: uuid description: L'UUID del tag, lo stesso valore passato come `tag_uuid`. name: type: string color: type: string description: Colore esadecimale, ad esempio `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` per un tag predefinito di Didit, `custom` per un tag creato dal tuo team. added_by: type: string nullable: true description: >- Email del membro della console che ha aggiunto il tag. Null se aggiunto tramite chiave API. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Lo stato delle persone e delle aziende della rete. Ciascun membro visibile viene conteggiato una sola volta, in base allo stato della verifica più recente che ha raggiunto una decisione. Le parti della transazione non vengono conteggiate. properties: approved: type: integer description: Membri la cui verifica decisa più recente è stata approvata. declined: type: integer description: Membri la cui verifica decisa più recente è stata rifiutata. in_review: type: integer description: Membri la cui verifica decisa più recente è in revisione. total: type: integer description: >- Membri con almeno una verifica, decisa o meno. Un membro le cui verifiche sono tutte senza decisione (non avviata, in corso, scaduta o abbandonata) viene conteggiato qui e in nessun'altra chiave. NetworkPatternScore: type: object description: >- Grado di somiglianza di un tipo di dati dei membri all'interno dell'intera rete. Un pattern non costituisce un segnale: nessun valore condiviso collega i membri. properties: type: type: string enum: - background description: >- `background`: la somiglianza media dello sfondo dei selfie di ogni coppia di membri, con la persona mascherata. Legge il selfie più recente di ciascuna persona, al massimo i 50 più recenti, ed esclude le sessioni di verifica dell'età. Copre l'intera rete, non solo i membri delle tue applicazioni. score: type: number nullable: true minimum: 0 maximum: 1 description: >- Da 0 a 1, arrotondato a 4 decimali. Null quando `reason` è impostato. members: type: integer nullable: true description: >- Di quanti membri sono stati confrontati i selfie dal punteggio. Un selfie illeggibile o con troppo poco sfondo non viene confrontato. Null durante `computing`; 0 o 1 con `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Il motivo per cui non è presente un punteggio. `computing`: il punteggio per i membri attuali è in fase di calcolo; interroga nuovamente la rete più tardi. `not_enough_selfies`: meno di due membri hanno un selfie utilizzabile. Null quando è presente un punteggio. computed_at: type: string format: date-time nullable: true description: >- Quando il punteggio è stato calcolato. Null mentre è in stato `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: >- ID sequenziale per organizzazione leggibile dall'utente, ad es. N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Stato del ciclo di vita della rete. Distinto dall'outcome_status per richiedente all'interno di una rete (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: I pattern di clustering rilevati in questa rete. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: I diversi tipi di segnale presenti in questa rete. member_counts: type: object description: >- Conteggi dei membri per categoria (ad es. totale, per outcome_status). member_status: type: object description: Suddivisione dei membri per outcome_status. signal_coverage: type: object description: Copertura per signal_type dei membri di questa rete. 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: Punteggio di rischio, 0-100. band: type: string enum: - low - medium - high description: >- Fascia a cui viene assegnato il punteggio. high >= 70, medium >= 40, altrimenti low. bar: type: number format: float description: >- Valore normalizzato compreso tra 0 e 1 per il rendering di una barra di rischio. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.