はじめに
連携 / SDK
ユーザー認証
法人確認
トランザクションモニタリング
変更履歴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_husing 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"
}
]
}
ネットワーク
不正ネットワーク取得API
Didit Management APIで不正ネットワーク1件の全情報を取得。統計、不正タグ、リスクシグナル、独自タグ、メンバーの結果、セルフィー背景パターンスコア、組織間アクセスを確認できます。
GET
/
v3
/
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_husing 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"
}
]
}
ネットワークの概要パネルの表示に必要なすべての情報を含むネットワークを1件取得します。一覧と共通のフィールドに加えて、リスクの内訳、検出された不正タグ、リスクシグナルの概要が含まれます。
詳細には、アプリケーションがネットワークに付けたタグ、メンバーの認証の状況、メンバーのセルフィー背景の類似度も含まれます。
却下された後、再試行で承認されたメンバーは
読み取れないセルフィーや背景の写りが少なすぎるセルフィーは比較されないため、
タグ
tagsには、ネットワーク上のアプリケーションのタグが古い順に並びます。
各アプリケーションが参照・変更できるのは、自身のタグのみです。
added_byは、タグを追加したコンソールメンバーのメールアドレスです。APIキーで追加された場合はnullになります。
タグを変更するには、ネットワークタグの追加とネットワークタグの削除を使用します。
fraud_tagsは変わりません。ネットワークのメンバーに付いているタグが並びます。
メンバーの判定結果
outcomesは、ネットワーク内であなたが参照できる個人と企業の数を、それぞれ1回ずつ数えたものです。
| キー | 数える対象 |
|---|---|
approved | 判定済みの最新の認証が承認済みのメンバー |
declined | 判定済みの最新の認証が却下のメンバー |
in_review | 判定済みの最新の認証がレビュー中のメンバー |
total | 判定の有無を問わず、認証が1件以上あるメンバー |
approvedとして数えられます。
すべての認証が未判定(未開始、進行中、期限切れ、放棄)のメンバーは、totalにのみ数えられます。
取引の当事者は認証を受けないため、数に含まれません。
セルフィー背景のパターン
現在、patternsにはtypeがbackgroundの項目が1件含まれます。
そのscoreは0〜1の値で、人物部分をマスクしたうえで、メンバーのセルフィー背景のすべての組み合わせについて算出した類似度の平均です。
スコアが1に近い場合、セルフィーが同じ場所で撮影された可能性があります。
似た色の無地の壁でもスコアが高くなることがあるため、スコアは証明ではなく、レビューのための根拠として扱ってください。
スコアには各人物の最新のセルフィーを使用し、対象は新しいものから最大50件です。年齢確認セッションは除外されます。
スコアはあなたのアプリケーションのメンバーだけでなく、ネットワーク全体を対象とします。
reason | score | members | 対応 |
|---|---|---|---|
null | 0〜1 | 比較したセルフィーの数 | スコアを使用します。computed_atは算出日時を示します。 |
computing | null | null | 現在のメンバーのスコアを算出中です。後でネットワークを再度取得してください。 |
not_enough_selfies | null | 0または1 | 使用可能なセルフィーがあるメンバーが2人未満です。 |
membersがネットワーク内の人数より少なくなることがあります。
スコアは常に現在のメンバーのセルフィーを表します。
メンバーの参加や離脱などでセルフィーが変わると、新しいスコアが算出されるまで詳細はcomputingを返します。残りが2人未満の場合はnot_enough_selfiesを返します。
組織横断での利用可否
詳細には、ネットワーク一覧の取得と同じsharing_mode、cross_org_available、cross_org_unavailable_reasonが含まれます。
組織横断のシグナルを利用するには、Enterpriseプランとglobal共有モードの両方が必要です。
関連項目
承認
お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys
パスパラメータ
組織のUUIDです。
アプリケーションのUUID。
ネットワークのUUID。
例:
"n3a5e000-0000-4000-8000-000000000001"
レスポンス
ネットワークの詳細。
ネットワークの詳細に加え、組織の共有モード、組織横断のシグナルが組織に適用されるかどうか、ネットワークに対するアプリケーションのタグ、メンバーの結果、パターンスコアです。
組織ごとに付与される、人が読める形式の連番ID。例: N-0001。
ネットワークのライフサイクルステータス。ネットワーク内の申請者ごとのoutcome_status（approved/in_review/declined/not_completed）とは異なります。
利用可能なオプション:
active, in_review, resolved, dismissed Show child attributes
Show child attributes
このネットワークで検出されたクラスタリングパターン。
利用可能なオプション:
exact_same_device, similar_device, same_ip_address, same_address, similar_selfie_backgrounds, similar_poa_documents, same_document_number, same_phone_number, same_email このネットワークに含まれるシグナルタイプ（重複なし）です。
利用可能なオプション:
ip_address, device, face, document_number, phone, email, address カテゴリ別のメンバー数（例: 合計、outcome_statusごと）。
outcome_status別のメンバーの内訳。
このネットワークのメンバーにおけるsignal_typeごとのカバレッジ。
ネットワークの集計統計（例:メンバー総数）。
ネットワーク上で検出された不正パターンのタグ。
リスクシグナルの概要: residential_proxy_reuse、email_intelligence、phone_intelligence。
この調査に含まれる、アナリスト専用の非公開メモの数。
必須範囲:
x >= 0組織の組織間共有モード。globalのみが組織をまたいでネットワークを比較します。privateとoffでは、比較は組織自身の履歴内に限定されます。
利用可能なオプション:
off, private, global 例:
"global"
この組織に組織横断シグナルが適用されるかどうかです。Enterpriseプランとglobal共有モードの両方が必要です。
例:
true
組織間シグナルが適用されない理由。以下の順にチェックされます。plan：組織のプランに組織間不正ネットワークが含まれていません（Enterpriseプランが必要です）。共有モードに関係なく該当します。sharing_mode：プランには含まれていますが、共有モードがprivateまたはoffです。cross_org_availableがtrueの場合はnullです。
利用可能なオプション:
plan, sharing_mode 例:
null
ネットワーク上のお客様のアプリケーションのタグです。古い順に並びます。各アプリケーションには自身のタグのみが表示されます。fraud_tagsはこれとは別で、変更されません。ネットワークのメンバーが持つタグです。
Show child attributes
Show child attributes
ネットワーク内の個人と企業の状況です。閲覧可能な各メンバーは、判定に至った最新の検証のステータスに基づいて1回ずつカウントされます。取引の当事者はカウントされません。
Show child attributes
Show child attributes
ネットワーク全体のパターンスコア。現在はbackgroundの1項目です。
Show child attributes
Show child attributes
最終更新日 2026年11月1日