API de cronología de redes de fraude

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/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

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/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

Obtén el historial de eventos de una red. Sin contract, la respuesta es el historial propio de la red, del más antiguo al más reciente y sin paginación: cuándo se detectó por primera vez, cuándo se observó por última vez cada señal y su último cambio de estado con su motivo. Este formato no cambia, y limit, cursor y event_type se ignoran.

Cronología tipada

Pasa contract=2 para leer la cronología tipada en su lugar. Añade lo que hicieron las cuentas de los miembros y lo que hizo tu equipo con respecto a la red, del más reciente al más antiguo, una página cada vez. contract solo acepta 2; cualquier otro valor devuelve 400.

Parámetro	Significado
`limit`	Eventos por página, de 1 a 500. El valor predeterminado es 100.
`cursor`	El `next_cursor` de la página anterior. Un cursor no válido o vacío devuelve `400`.
`event_type`	Los tipos de evento que se conservan, repetidos o separados por comas, con un máximo de 20 valores. De forma predeterminada, todos los tipos.

La respuesta es {"results": [...], "next_cursor": "..."}. Lee la página siguiente con cursor igual a next_cursor, hasta que next_cursor sea null.

Tipos de evento

`event_type`	Qué registra	Bloque de detalle
`network_detected`	Se detectó la red	Ninguno
`signal_observed`	La última observación de una señal	Ninguno
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	El último cambio de estado de la red, con su motivo en `metadata`	Ninguno
`verification_attempt`	Una sesión de verificación de un miembro (una persona o una empresa), numerada (`attempt` de `attempt_count`), con sus motivos de rechazo cuando se rechazó	`verification_attempt`
`transaction`	Una transacción en la que participó un miembro, fechada según su fecha de transacción	`transaction`
`login`	Un inicio de sesión o un inicio de sesión fallido que enviaste para un miembro a través de la API de eventos	`login`
`rule_hit`	Una regla activa que coincidió con una transacción o un evento de un miembro	`rule_hit`
`case_linked`	Un caso abierto para la red en tu organización	`case_linked`
`note_added`	Una nota añadida a la red, sin su texto	`note_added`

Los eventos note_added solo se devuelven a los miembros de la consola, nunca a una clave de API. Una transacción entre dos miembros aparece una vez para cada uno de ellos, cada una con su propia account. Una coincidencia con una regla en esa transacción aparece una sola vez. Los eventos de inicio de sesión solo existen para los inicios de sesión que envías como eventos: auth.login, security.login_succeeded y sus variantes fallidas.

Cuentas y registros

Cada evento de miembro incluye account, el miembro al que pertenece, y source_ref, la sesión, sesión de empresa, transacción, evento de monitorización o caso del que se obtuvo. ownership es owned cuando el registro pertenece a la aplicación a la que invocaste, y organization cuando pertenece a otra aplicación de tu organización. route indica el tipo, el UUID y la aplicación del registro; source_ref no tiene route para un evento de monitorización ni para un caso. Los eventos propios de la red no incluyen ni account ni source_ref.

Contenido 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.

network_uuid

string<uuid>

requerido

UUID de la red.

Ejemplo:

"n3a5e000-0000-4000-8000-000000000001"

Parámetros de consulta

contract

enum<string>

2 devuelve la línea de tiempo tipada. Omítelo para obtener la línea de tiempo predeterminada. Cualquier otro valor devuelve 400.

Opciones disponibles:

2

limit

integer

predeterminado:100

Solo para la cronología tipada. Eventos por página, de 1 a 500. El valor predeterminado es 100.

Rango requerido: 1 <= x <= 500

cursor

string

Solo para la cronología tipada. El next_cursor de la página anterior. Un cursor no válido o vacío devuelve 400.

event_type

enum<string>[]

Solo para la cronología tipada. Tipos de eventos que se conservan, repetidos o separados por comas, con un máximo de 20 valores. De forma predeterminada, todos los tipos.

Maximum array length: 20

Opciones disponibles:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Respuesta

Sin contract: {results}, del más antiguo al más reciente, sin paginar. Con contract=2: {results, next_cursor}, del más reciente al más antiguo.

Default timeline (no contract)
Typed timeline page (contract=2)

Sin contract: los eventos propios de la red, del más antiguo al más reciente, sin paginar.

results

object[]

Show child attributes

Última modificación el 1 de noviembre de 2026

​Cronología tipada

​Tipos de evento

​Cuentas y registros

​Contenido relacionado

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

Cronología tipada

Tipos de evento

Cuentas y registros

Contenido relacionado