API de chronologie du réseau 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."
      }
    }
  ]
}

Récupérez l’historique des événements d’un réseau. Sans contract, la réponse est l’historique propre au réseau, du plus ancien au plus récent, sans pagination : la date de première détection, la dernière observation de chaque signal et son dernier changement de statut, avec son motif. Cette structure est inchangée, et limit, cursor et event_type sont ignorés.

Chronologie typée

Passez contract=2 pour lire à la place la chronologie typée. Elle ajoute ce que les comptes membres ont fait et ce que votre équipe a fait à propos du réseau, du plus récent au plus ancien, une page à la fois. contract n’accepte que 2 ; toute autre valeur renvoie 400.

Paramètre	Signification
`limit`	Événements par page, de 1 à 500. Valeur par défaut : 100.
`cursor`	Le `next_cursor` de la page précédente. Un curseur invalide ou vide renvoie `400`.
`event_type`	Les types d’événements à conserver, répétés ou séparés par des virgules, 20 valeurs au maximum. Par défaut, tous les types.

La réponse est {"results": [...], "next_cursor": "..."}. Lisez la page suivante avec cursor défini sur next_cursor, jusqu’à ce que next_cursor soit null.

Types d’événements

`event_type`	Ce qu’il enregistre	Bloc de détail
`network_detected`	Le réseau a été détecté	Aucun
`signal_observed`	La dernière observation d’un signal	Aucun
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	Le dernier changement de statut du réseau, avec son motif dans `metadata`	Aucun
`verification_attempt`	Une session de vérification d’un membre (une personne ou une entreprise), numérotée (`attempt` parmi `attempt_count`), avec ses motifs de refus lorsqu’elle a été refusée	`verification_attempt`
`transaction`	Une transaction à laquelle un membre a participé, datée de sa date de transaction	`transaction`
`login`	Une connexion, ou un échec de connexion, que vous avez transmis pour un membre via l’API d’événements	`login`
`rule_hit`	Une règle active qui a correspondu à une transaction ou à un événement d’un membre	`rule_hit`
`case_linked`	Un dossier ouvert pour le réseau dans votre organisation	`case_linked`
`note_added`	Une note ajoutée au réseau, sans son texte	`note_added`

Les événements note_added ne sont renvoyés qu’aux membres de la console, jamais à une clé API. Une transaction entre deux membres apparaît une fois pour chacun d’eux, chaque occurrence ayant son propre account. Une règle qui correspond à cette transaction n’apparaît qu’une fois. Les événements de connexion n’existent que pour les connexions que vous transmettez sous forme d’événements : auth.login, security.login_succeeded et leurs formes en échec.

Comptes et enregistrements

Chaque événement membre contient account, le membre auquel il appartient, et source_ref, la session, la session d’entreprise, la transaction, l’événement de surveillance ou le dossier dont il a été extrait. ownership vaut owned lorsque l’enregistrement appartient à l’application que vous avez appelée, et organization lorsqu’il appartient à une autre application de votre organisation. route indique le type de l’enregistrement, son UUID et son application ; source_ref ne contient pas de route pour un événement de surveillance ou un dossier. Les événements propres au réseau ne contiennent ni account ni source_ref.

Voir aussi

Autorisations

x-api-key

string

header

requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

organization_id

string<uuid>

requis

UUID de l'organisation.

application_id

string<uuid>

requis

UUID de l'application.

network_uuid

string<uuid>

requis

UUID du réseau.

Exemple:

"n3a5e000-0000-4000-8000-000000000001"

Paramètres de requête

contract

enum<string>

2 renvoie la chronologie typée. Omettez-le pour la chronologie par défaut. Toute autre valeur renvoie 400.

Options disponibles:

2

limit

integer

défaut:100

Uniquement pour une chronologie typée. Événements par page, de 1 à 500. Valeur par défaut : 100.

Plage requise: 1 <= x <= 500

cursor

string

Uniquement pour une chronologie typée. Le next_cursor de la page précédente. Un curseur invalide ou vide renvoie 400.

event_type

enum<string>[]

Uniquement pour une chronologie typée. Types d'événements à conserver, répétés ou séparés par des virgules, au maximum 20 valeurs. Par défaut, tous les types.

Maximum array length: 20

Options disponibles:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Réponse

Sans contract : {results}, les plus anciens d'abord, non paginé. Avec contract=2 : {results, next_cursor}, les plus récents d'abord.

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

Sans contract : les événements propres au réseau, du plus ancien au plus récent, non paginés.

results

object[]

Show child attributes

Dernière modification le 7 novembre 2026

​Chronologie typée

​Types d’événements

​Comptes et enregistrements

​Voir aussi

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

Chronologie typée

Types d’événements

Comptes et enregistrements

Voir aussi