API para listar redes de fraude

curl

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

for await (const item of didit.networks.list()) {
  console.log(item);
}

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

for (var item : client.networks().list()) {
    System.out.println(item);
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

foreach ($didit->networks->list() as $item) {
    print_r($item->toArray());
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

await foreach (var item in await client.Networks.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 123,
  "next": 123,
  "previous": 123,
  "results": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "network_id": "<string>",
      "name": "<string>",
      "status": "active",
      "risk": {
        "score": 123,
        "band": "low",
        "bar": 123
      },
      "pattern_types": [
        "exact_same_device"
      ],
      "signal_types": [
        "ip_address"
      ],
      "member_counts": {},
      "member_status": {},
      "signal_coverage": {},
      "first_activity_at": "2023-11-07T05:31:56Z",
      "last_activity_at": "2023-11-07T05:31:56Z"
    }
  ],
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "kpis": {
    "active": {},
    "in_review": {},
    "applicants_involved": {},
    "detected_this_period": {},
    "false_positive_rate": {}
  },
  "counts": {
    "scopes": {
      "all": 123,
      "identity": 123,
      "transactions": 123
    },
    "views": {
      "all": 123,
      "active": 123,
      "in_review": 123,
      "resolved": 123,
      "dismissed": 123,
      "mine": 123,
      "high_risk": 123
    },
    "facets": {
      "total": 123,
      "last_activity_days": {
        "7": 123,
        "30": 123,
        "90": 123
      },
      "risk_min": {
        "50": 123,
        "80": 123
      },
      "signal_types": {
        "ip_address": 123,
        "device": 123,
        "face": 123,
        "document_number": 123,
        "phone": 123,
        "email": 123,
        "address": 123
      },
      "priority": {
        "low": 123,
        "medium": 123,
        "high": 123,
        "none": 123
      },
      "assignee": {
        "me": 123,
        "unassigned": 123,
        "users": [
          {
            "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "full_name": "<string>",
            "email": "<string>",
            "count": 123
          }
        ]
      },
      "has_case": 123,
      "min_size": {
        "10": 123
      }
    }
  }
}

GET

organization

{organization_id}

application

{application_id}

networks

curl

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

for await (const item of didit.networks.list()) {
  console.log(item);
}

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

for (var item : client.networks().list()) {
    System.out.println(item);
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

foreach ($didit->networks->list() as $item) {
    print_r($item->toArray());
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

await foreach (var item in await client.Networks.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 123,
  "next": 123,
  "previous": 123,
  "results": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "network_id": "<string>",
      "name": "<string>",
      "status": "active",
      "risk": {
        "score": 123,
        "band": "low",
        "bar": 123
      },
      "pattern_types": [
        "exact_same_device"
      ],
      "signal_types": [
        "ip_address"
      ],
      "member_counts": {},
      "member_status": {},
      "signal_coverage": {},
      "first_activity_at": "2023-11-07T05:31:56Z",
      "last_activity_at": "2023-11-07T05:31:56Z"
    }
  ],
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "kpis": {
    "active": {},
    "in_review": {},
    "applicants_involved": {},
    "detected_this_period": {},
    "false_positive_rate": {}
  },
  "counts": {
    "scopes": {
      "all": 123,
      "identity": 123,
      "transactions": 123
    },
    "views": {
      "all": 123,
      "active": 123,
      "in_review": 123,
      "resolved": 123,
      "dismissed": 123,
      "mine": 123,
      "high_risk": 123
    },
    "facets": {
      "total": 123,
      "last_activity_days": {
        "7": 123,
        "30": 123,
        "90": 123
      },
      "risk_min": {
        "50": 123,
        "80": 123
      },
      "signal_types": {
        "ip_address": 123,
        "device": 123,
        "face": 123,
        "document_number": 123,
        "phone": 123,
        "email": 123,
        "address": 123
      },
      "priority": {
        "low": 123,
        "medium": 123,
        "high": 123,
        "none": 123
      },
      "assignee": {
        "me": 123,
        "unassigned": 123,
        "users": [
          {
            "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "full_name": "<string>",
            "email": "<string>",
            "count": 123
          }
        ]
      },
      "has_case": 123,
      "min_size": {
        "10": 123
      }
    }
  }
}

Lista las redes de fraude detectadas para tu organización. De forma predeterminada, la lista se ordena por puntuación de riesgo, de mayor a menor, y después por la actividad más reciente. Cada filtro disponible en la lista de redes de la Console se expone como parámetro de consulta, incluida la búsqueda de texto libre q y los mismos chips de estado, señal, patrón y franja de riesgo. Los parámetros assignee, priority, risk_min y has_case corresponden a las opciones de persona asignada, prioridad, riesgo mínimo y caso vinculado que contabiliza counts.facets. assignee=me requiere un token de miembro de la consola; con una clave de API devuelve 400.

Las aplicaciones de sandbox nunca tienen redes. La agrupación se ejecuta solo con datos de producción.

Modo de compartición y señales entre organizaciones

Cada respuesta incluye los campos sharing_mode, cross_org_available y cross_org_unavailable_reason de tu organización.

Campo	Significado
`sharing_mode`	El modo de compartición entre organizaciones de la organización. Solo `global` compara redes entre organizaciones; `private` y `off` las limitan al historial propio de la organización.
`cross_org_available`	Si las señales entre organizaciones se aplican a tu organización. Requieren tanto el plan Enterprise como el modo de compartición `global`.
`cross_org_unavailable_reason`	`plan` cuando tu plan no incluye la red de fraude entre organizaciones (requiere el plan Enterprise), sea cual sea tu modo de compartición. `sharing_mode` cuando el plan la incluye pero tu modo de compartición es `private` u `off`. `null` cuando `cross_org_available` es `true`.

El plan se comprueba primero: con un plan inferior al Enterprise, el motivo es plan incluso cuando tu modo de compartición es global.

Recuentos y el parámetro summary

kpis agrega las redes que coinciden con tus filtros y counts agrega todas las redes que tu aplicación puede ver, por lo que ambos son más costosos que la propia página. Pasa summary=false cuando solo necesites la página y su count: en ese caso, la respuesta omite kpis y counts. summary solo acepta true o false; cualquier otro valor devuelve 400. counts contiene las cifras de las vistas y las opciones de filtro de la lista, y cada red se cuenta una sola vez:

Clave	Qué cuenta
`scopes`	Todas las redes visibles (`all`), divididas en `transactions` (todos los miembros son partes de una transacción) e `identity` (todas las demás redes).
`views`	Las redes visibles dentro del `scope` seleccionado (`all`), por estado (`active`, `in_review`, `resolved`, `dismissed`), asignadas al miembro de la consola que realiza la solicitud (`mine`) y `high_risk` (puntuación de riesgo de 80 o más, no descartadas).
`facets`	Las redes en el `scope` y la vista de `status` seleccionados (`total`), por actividad reciente (`last_activity_days`: 7, 30, 90), riesgo mínimo (`risk_min`: 50, 80), tipo de señal, prioridad (incluido `none`), persona asignada (`me`, `unassigned` y una entrada por cada persona asignada en `users`), redes para las que tu aplicación abrió un caso (`has_case`) y redes con al menos 10 miembros (`min_size`).

Los filtros distintos de scope y status no modifican counts. views.mine y facets.assignee.me son siempre 0 con una clave de API, ya que ningún miembro de la consola realiza la solicitud.

Acceso

Los endpoints de Networks requieren una clave de API con acceso completo. Con una clave con acceso restringido, se recibe un 403. Un token de miembro de la consola requiere list:networks. Cuando Networks no está habilitado para tu organización, todos los endpoints de Networks devuelven 403 con "code": "networks_not_entitled".

Relacionado

Autorizaciones

x-api-key

string

header

requerido

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.

Parámetros de ruta

organization_id

string<uuid>

requerido

UUID de la organización.

application_id

string<uuid>

requerido

UUID de la aplicación.

Parámetros de consulta

status

string

Estados que se incluirán, separados por comas: active,in_review,resolved,dismissed. Si se omite, se excluyen los descartados.

scope

enum<string>

transactions conserva las redes cuyos miembros son todos partes de transacciones; identity conserva todas las demás redes. Omítelo para obtener ambas. También acota counts.views y counts.facets. Cualquier otro valor devuelve 400.

Opciones disponibles:

identity,

transactions

signal_type

string

Tipos de señal separados por comas: ip_address,device,face,document_number,phone,email,address.

pattern_type

string

Tipos de patrón separados por comas, por ejemplo, exact_same_device,same_email.

risk_band

string

Bandas separadas por comas: low,medium,high.

min_size

integer

Número mínimo de miembros.

max_size

integer

Número máximo de miembros.

assignee

string

Asignados separados por comas: unassigned, correos electrónicos de miembros (se comparan sin distinguir mayúsculas de minúsculas) o me para el miembro de la consola que hace la llamada. Una red coincide con cualquier valor. me requiere un token de miembro de la consola: con una clave de API se obtiene un 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}.

priority

string

Prioridades separadas por comas: low, medium, high o none para redes sin prioridad. Cualquier otro valor devuelve 400 {"priority": "Unknown priority: <values>."}.

risk_min

integer

Puntuación de riesgo mínima, un número entero de 0 a 100. Un valor que no sea un número entero devuelve 400 {"risk_min": "Use a whole number from 0 to 100."}.

Rango requerido: 0 <= x <= 100

has_case

boolean

true conserva las redes para las que tu aplicación abrió un caso; false, las demás. Cualquier otro valor se ignora.

date_from

string<date>

Límite inferior de last_activity_at (fecha o fecha y hora ISO 8601).

date_to

string<date>

Límite superior de first_activity_at (fecha o fecha y hora ISO 8601).

string

Búsqueda en texto libre por nombre de la red, nombres de los miembros, el network_id (N-0001) y tokens exactos de pattern_type.

ordering

string

Uno de risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. Valor predeterminado: -risk_score,-last_activity_at.

limit

integer

predeterminado:100

Tamaño de página, de 1 a 500. El valor predeterminado es 100.

Rango requerido: 1 <= x <= 500

offset

integer

predeterminado:0

Desplazamiento, empezando en cero, del primer registro.

Rango requerido: x >= 0

summary

boolean

predeterminado:true

false devuelve solo la página y su count, sin kpis ni counts. El valor predeterminado es true. Cualquier valor distinto de true o false devuelve 400.

Respuesta

Lista paginada de redes, con el modo de compartición de la organización y la disponibilidad entre organizaciones, además de kpis y counts salvo que summary=false.

count

integer

requerido

integer | null

requerido

Desplazamiento (offset) de la página siguiente, o null en la última página.

integer | null

requerido

results

object[]

requerido

Show child attributes

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.

Opciones disponibles:

off,

private,

global

Ejemplo:

"global"

cross_org_available

boolean

requerido

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.

Ejemplo:

true

cross_org_unavailable_reason

enum<string> | null

requerido

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.

Opciones disponibles:

plan,

sharing_mode

Ejemplo:

null

kpis

object

Cada clave es {value, delta} sobre los resultados que coinciden con los filtros actuales. Se omite cuando summary=false.

Show child attributes

counts

object

Recuentos de redes para las vistas y las opciones de filtro de la lista; cada red se cuenta una sola vez. Solo se devuelven cuando summary no es false. scopes cuenta todas las redes visibles para la aplicación. views cuenta las redes visibles dentro del scope seleccionado. facets cuenta las redes del scope y la vista de status seleccionados (las redes descartadas quedan fuera salvo que status las incluya). Los demás filtros de la lista no modifican estos recuentos.

Show child attributes

Última modificación el 1 de noviembre de 2026

​Modo de compartición y señales entre organizaciones

​Recuentos y el parámetro summary

​Acceso

​Relacionado

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

Modo de compartición y señales entre organizaciones

Recuentos y el parámetro summary

Acceso

Relacionado