> ## 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 para obtener una red de fraude > Obtén una red de fraude de Didit: estadísticas, etiquetas, señales de riesgo, resultados de miembros, puntuación de fondo de selfie y acceso cruzado. Prompt de la API para obtener una red Copiar el prompt al portapapeles \

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

\
Pegar en Obtén una red con todo lo necesario para mostrar el panel de resumen de una red: su desglose de riesgo, las etiquetas de fraude detectadas y los resúmenes de señales de riesgo, además de los campos que comparte con el listado. El detalle también incluye las etiquetas de tu aplicación en la red, el estado de las verificaciones de sus miembros y el grado de similitud entre los fondos de sus selfies.## Etiquetas`tags` lista las etiquetas de tu aplicación en la red, de la más antigua a la más reciente. Cada aplicación solo ve y modifica sus propias etiquetas. `added_by` es el correo electrónico del miembro de la consola que añadió la etiqueta, o `null` cuando la añadió una clave de API. Usa [Añadir etiqueta de red](https://docs.didit.me/es/management-api/networks/add-tag.md) y [Eliminar etiqueta de red](https://docs.didit.me/es/management-api/networks/remove-tag.md) para modificarlas. `fraud_tags` no cambia: lista las etiquetas que tienen los miembros de la red.## Resultados de los miembros`outcomes` cuenta las personas y empresas de la red que puedes ver, y cada una se cuenta una sola vez.| Clave | Qué cuenta | | - | - | | `approved` | Miembros cuya verificación decidida más reciente fue aprobada | | `declined` | Miembros cuya verificación decidida más reciente fue rechazada | | `in_review` | Miembros cuya verificación decidida más reciente está en revisión | | `total` | Miembros con al menos una verificación, decidida o no |Un miembro rechazado y aprobado después en un reintento cuenta como `approved`. Un miembro sobre cuyas verificaciones no se ha tomado ninguna decisión (no iniciadas, en curso, expiradas o abandonadas) solo cuenta en `total`. Las partes de una transacción no pasan por ninguna verificación y no se cuentan.## Patrón de fondo de las selfies`patterns` contiene actualmente un solo elemento, con `type` igual a `background`. Su `score`, de 0 a 1, es la similitud media de todos los pares de fondos de las selfies de los miembros, con la persona enmascarada. Una puntuación cercana a 1 sugiere que las selfies se tomaron en el mismo lugar. Las paredes lisas de un color parecido también pueden obtener una puntuación alta, así que trata la puntuación como un indicio para la revisión, no como una prueba. La puntuación se calcula a partir de la selfie más reciente de cada persona, como máximo las 50 más recientes, y excluye las sesiones de verificación de edad. Abarca toda la red, no solo los miembros de tus aplicaciones.| `reason` | `score` | `members` | Qué hacer | | - | - | - | - | | `null` | 0 a 1 | Selfies comparadas | Usa la puntuación. `computed_at` indica cuándo se calculó. | | `computing` | `null` | `null` | Se está calculando la puntuación para los miembros actuales. Vuelve a consultar la red más tarde. | | `not_enough_selfies` | `null` | `0` o `1` | Menos de dos miembros tienen una selfie utilizable. |Una selfie que no se puede leer, o que muestra demasiado poco fondo, no se compara, por lo que `members` puede ser menor que el número de personas de la red. La puntuación siempre describe las selfies actuales de los miembros. Cuando cambian, por ejemplo cuando un miembro se une o sale, el detalle indica `computing` hasta que la nueva puntuación esté lista, o `not_enough_selfies` cuando quedan menos de dos.## Disponibilidad entre organizacionesEl detalle incluye los mismos `sharing_mode`, `cross_org_available` y `cross_org_unavailable_reason` que [listar redes](https://docs.didit.me/es/management-api/networks/list.md#modo-de-compartición-y-señales-entre-organizaciones). Las señales entre organizaciones requieren tanto el plan Enterprise como el modo de compartición `global`.## Contenido relacionado- [Listar redes](https://docs.didit.me/es/management-api/networks/list.md) - [Añadir etiqueta a una red](https://docs.didit.me/es/management-api/networks/add-tag.md) - [Eliminar etiqueta de una red](https://docs.didit.me/es/management-api/networks/remove-tag.md) - [Miembros de la red](https://docs.didit.me/es/management-api/networks/members.md) - [Grafo de la red](https://docs.didit.me/es/management-api/networks/graph.md) ## OpenAPI ````yaml es/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 de verificación de identidad. Autentícate con el encabezado 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: Obtener una red description: >- Obtén el detalle completo de una red: estadísticas, etiquetas de fraude y señales de riesgo, además del `sharing_mode` de la organización y la disponibilidad entre organizaciones, las `tags` de tu aplicación en la red, los `outcomes` de los miembros y las puntuaciones de patrones (`patterns`). Requiere una clave de API con acceso completo, o `read:networks` para un miembro de la consola. operationId: get_network parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de la organización. - name: application_id in: path required: true schema: type: string format: uuid description: UUID de la aplicación. - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: UUID de la red. responses: '200': description: Detalle de la red. 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: Credenciales ausentes o no válidas. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente en errores con código, por ejemplo `networks_not_entitled`. examples: Missing or invalid credentials: summary: Credenciales ausentes o no válidas value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- La clave de API pertenece a otra aplicación o es una clave con acceso restringido: los endpoints de Networks necesitan una clave de acceso completo. Un token de miembro de la consola necesita `read:networks`. También se devuelve con `code: networks_not_entitled` cuando Networks no está habilitado para la organización. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente en errores con código, por ejemplo `networks_not_entitled`. examples: Networks not enabled: summary: Redes no habilitadas 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: Clave de API restringida value: detail: This API key has no access to this endpoint. No permission: summary: Sin permiso value: detail: You do not have permission to perform this action. '404': description: Red no encontrada (o no visible para esta aplicación). 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: >- El detalle de la red, junto con el modo de compartición de la organización, si se le aplican las señales entre organizaciones, las etiquetas de tu aplicación en la red, los resultados de los miembros y las puntuaciones de patrones. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- El modo de uso compartido entre organizaciones de la organización. Solo `global` compara redes entre organizaciones; `private` y `off` las limitan al historial propio de la organización. example: global cross_org_available: type: boolean description: >- Indica si las señales entre organizaciones se aplican a esta organización. Requieren tanto el plan Enterprise como el modo de compartición `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Por qué no se aplican las señales entre organizaciones, comprobado en este orden. `plan`: el plan de la organización no incluye la red de fraude entre organizaciones (requiere el plan Enterprise), sea cual sea el modo de compartición. `sharing_mode`: el plan la incluye, pero el modo de compartición es `private` u `off`. Null cuando `cross_org_available` es `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- Las etiquetas de tu aplicación en la red, de la más antigua a la más reciente. Cada aplicación solo ve sus propias etiquetas. `fraud_tags` es independiente y no cambia: son las etiquetas que tienen los miembros de la red. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: >- Puntuaciones de patrones sobre toda la red. Actualmente, un elemento: `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: Estadísticas agregadas de la red (p. ej., totales de miembros). fraud_tags: type: array items: type: object description: Etiquetas de patrones de fraude detectadas en la red. risk_signals: type: object description: >- Resúmenes de señales de riesgo: 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: Número de notas privadas de analistas en esta investigación. NetworkTag: type: object description: Una de las etiquetas de tu aplicación en la red. properties: uuid: type: string format: uuid description: El UUID de la etiqueta, el mismo valor que pasas como `tag_uuid`. name: type: string color: type: string description: Color hexadecimal, por ejemplo `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` para una etiqueta predefinida de Didit, `custom` para una etiqueta que creó tu equipo. added_by: type: string nullable: true description: >- Correo electrónico del miembro de la consola que añadió la etiqueta. Null cuando la añadió una clave de API. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Estado de las personas y empresas de la red. Cada miembro que puedes ver cuenta una vez, según el estado de su verificación más reciente que llegó a una decisión. Las partes de las transacciones no se cuentan. properties: approved: type: integer description: Miembros cuya verificación decidida más reciente fue aprobada. declined: type: integer description: Miembros cuya verificación decidida más reciente fue rechazada. in_review: type: integer description: Miembros cuya verificación decidida más reciente está en revisión. total: type: integer description: >- Miembros con al menos una verificación, decidida o no. Un miembro cuyas verificaciones están todas sin decidir (no iniciadas, en curso, expiradas o abandonadas) se cuenta aquí y en ninguna otra clave. NetworkPatternScore: type: object description: >- Qué tan parecido es un tipo de datos de los miembros en toda la red. Un patrón no es una señal: ningún valor compartido vincula a los miembros. properties: type: type: string enum: - background description: >- `background`: la similitud media de cada par de fondos de las selfies de los miembros, con la persona enmascarada. Lee la selfie más reciente de cada persona, como máximo las 50 más recientes, y excluye las sesiones de verificación de edad. Abarca toda la red, no solo los miembros de tus aplicaciones. score: type: number nullable: true minimum: 0 maximum: 1 description: >- De 0 a 1, redondeado a 4 decimales. Null cuando `reason` está definido. members: type: integer nullable: true description: >- Cuántas selfies de miembros comparó la puntuación. Una selfie que no se puede leer, o que muestra muy poco fondo, no se compara. Null mientras sea `computing`; 0 o 1 con `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Por qué no hay puntuación. `computing`: se está calculando la puntuación de los miembros actuales; vuelve a leer la red más tarde. `not_enough_selfies`: menos de dos miembros tienen una selfie utilizable. Es null cuando hay puntuación. computed_at: type: string format: date-time nullable: true description: >- Fecha y hora en que se calculó la puntuación. Nulo mientras está en `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: ID secuencial legible por organización, p. ej. N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Estado del ciclo de vida de la red. Es distinto del outcome_status de cada solicitante dentro de una red (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: Los patrones de agrupamiento detectados en esta red. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Los distintos tipos de señal presentes en esta red. member_counts: type: object description: >- Recuentos de miembros por categoría (p. ej., total, por outcome_status). member_status: type: object description: Desglose de los miembros por outcome_status. signal_coverage: type: object description: Cobertura por signal_type de los miembros de esta red. 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ón de riesgo, de 0 a 100. band: type: string enum: - low - medium - high description: >- Banda con la que se muestra la puntuación. high >= 70, medium >= 40; en otro caso, low. bar: type: number format: float description: Valor normalizado de 0 a 1 para representar una barra de riesgo. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.