API de détail d'un réseau de fraude

curl

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'

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)

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);

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

result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

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);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());

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

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));

{
  "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"
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

curl

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'

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)

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);

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

result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

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);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

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

$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());

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

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));

{
  "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"
    }
  ]
}

Récupérez un réseau avec tout ce qu’il faut pour afficher le panneau de synthèse d’un réseau : sa répartition des risques, les étiquettes de fraude détectées et les résumés des signaux de risque, en plus des champs partagés avec la liste. Le détail contient aussi les étiquettes de votre application sur le réseau, l’état des vérifications de ses membres, et le degré de similarité de leurs arrière-plans de selfies.

Étiquettes

tags liste les étiquettes de votre application sur le réseau, de la plus ancienne à la plus récente. Chaque application voit et modifie uniquement ses propres étiquettes. added_by est l’e-mail du membre de la console qui a ajouté l’étiquette, ou null lorsqu’une clé API l’a ajoutée. Utilisez Ajouter une étiquette de réseau et Supprimer une étiquette de réseau pour les modifier. fraud_tags ne change pas : il liste les étiquettes portées par les membres du réseau.

Résultats des membres

outcomes compte les personnes et les entreprises du réseau que vous pouvez voir, chacune comptée une seule fois.

Clé	Ce qu’il compte
`approved`	Membres dont la vérification la plus récente ayant fait l’objet d’une décision a été approuvée
`declined`	Membres dont la vérification la plus récente ayant fait l’objet d’une décision a été refusée
`in_review`	Membres dont la vérification la plus récente ayant fait l’objet d’une décision est en cours d’examen
`total`	Membres ayant au moins une vérification, décidée ou non

Un membre refusé puis approuvé après une nouvelle tentative compte comme approved. Un membre dont toutes les vérifications sont sans décision (non démarrées, en cours, expirées ou abandonnées) n’est compté que dans total. Les parties à une transaction ne passent par aucune vérification et ne sont pas comptées.

Motif de l’arrière-plan des selfies

patterns contient aujourd’hui un seul élément, dont type vaut background. Son score, de 0 à 1, correspond à la similarité moyenne de chaque paire d’arrière-plans de selfies des membres, la personne étant masquée. Un score proche de 1 suggère que les selfies ont été pris au même endroit. Des murs unis de couleur similaire peuvent aussi obtenir un score élevé. Considérez donc le score comme un élément à examiner, et non comme une preuve. Le score analyse le selfie le plus récent de chaque personne, dans la limite des 50 plus récents, et exclut les sessions d’estimation de l’âge. Il couvre l’ensemble du réseau, et pas seulement les membres de vos applications.

`reason`	`score`	`members`	Action à mener
`null`	0 à 1	Selfies comparés	Utilisez le score. `computed_at` indique quand il a été calculé.
`computing`	`null`	`null`	Le score des membres actuels est en cours de calcul. Récupérez à nouveau les données du réseau plus tard.
`not_enough_selfies`	`null`	`0` ou `1`	Moins de deux membres disposent d’un selfie exploitable.

Un selfie illisible, ou qui montre trop peu d’arrière-plan, n’est pas comparé : members peut donc être inférieur au nombre de personnes du réseau. Le score décrit toujours les selfies actuels des membres. Lorsqu’ils changent, par exemple lorsqu’un membre rejoint ou quitte le réseau, le détail indique computing jusqu’à ce que le nouveau score soit prêt, ou not_enough_selfies lorsqu’il reste moins de deux selfies exploitables.

Disponibilité inter-organisations

Le détail contient les mêmes sharing_mode, cross_org_available et cross_org_unavailable_reason que Lister les réseaux. Les signaux inter-organisations nécessitent à la fois le forfait Enterprise et le mode de partage global.

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"

Réponse

Détail du réseau.

Les détails du réseau, ainsi que le mode de partage de l'organisation, l'application ou non des signaux inter-organisations à celle-ci, les tags de votre application sur le réseau, les résultats des membres et les scores de schémas.

uuid

string<uuid>

network_id

string

Identifiant séquentiel par organisation lisible par l'utilisateur, par exemple N-0001.

name

string | null

status

enum<string>

Statut du cycle de vie du réseau. Distinct de l'outcome_status par candidat au sein d'un réseau (approved/in_review/declined/not_completed).

Options disponibles:

active,

in_review,

resolved,

dismissed

risk

object

Show child attributes

pattern_types

enum<string>[]

Les modèles de regroupement détectés dans ce réseau.

Options disponibles:

exact_same_device,

similar_device,

same_ip_address,

same_address,

similar_selfie_backgrounds,

similar_poa_documents,

same_document_number,

same_phone_number,

same_email

signal_types

enum<string>[]

Les types de signaux distincts présents dans ce réseau.

Options disponibles:

ip_address,

device,

face,

document_number,

phone,

email,

address

member_counts

object

Nombre de membres par catégorie (par ex. total, par outcome_status).

member_status

object

Répartition des membres par outcome_status.

signal_coverage

object

Couverture par signal_type des membres de ce réseau.

first_activity_at

string<date-time> | null

last_activity_at

string<date-time> | null

stats

object

Statistiques agrégées pour le réseau (par exemple totaux des membres).

fraud_tags

object[]

Tags de schémas de fraude détectés sur le réseau.

risk_signals

object

Résumés des signaux de risque : residential_proxy_reuse, email_intelligence, phone_intelligence.

reviewed_at

string<date-time> | null

reviewed_by

string | null

review_reason

string | null

notes_count

integer

read-only

Nombre de notes privées d'analyste dans cette enquête.

Plage requise: x >= 0

Le mode de partage inter-organisations de l'organisation. Seul global compare les réseaux entre organisations ; private et off les conservent dans l'historique propre à l'organisation.

Options disponibles:

off,

private,

global

Exemple:

"global"

cross_org_available

boolean

Indique si les signaux inter-organisations s'appliquent à cette organisation. Ils nécessitent à la fois le forfait Enterprise et le mode de partage global.

Exemple:

true

cross_org_unavailable_reason

enum<string> | null

Raison pour laquelle les signaux inter-organisations ne s'appliquent pas, vérifiée dans cet ordre. plan : le forfait de l'organisation n'inclut pas le réseau de fraude inter-organisations (le forfait Enterprise est requis), quel que soit le mode de partage. sharing_mode : le forfait l'inclut, mais le mode de partage est private ou off. Null lorsque cross_org_available est true.

Options disponibles:

plan,

sharing_mode

Exemple:

null

​Étiquettes

​Résultats des membres

​Motif de l’arrière-plan des selfies

​Disponibilité inter-organisations

​Voir aussi

Autorisations

Paramètres de chemin

Réponse

Étiquettes

Résultats des membres

Motif de l’arrière-plan des selfies

Disponibilité inter-organisations

Voir aussi