企業(KYB)のCRUD操作:作成・一覧・更新・削除

企業エンティティの管理はすべて、/v3/businesses/配下にある6つの公開エンドポイントを通じて行います。このページでは概念的な概要を説明します。リクエストとレスポンスの完全なスキーマについてはAPIリファレンスを参照してください。

企業の一覧取得

GET /v3/businesses/ アプリケーションに属する企業をページネーション付きの一覧で取得します。ステータス、検索語、国、日付範囲でフィルターできます。

curl -G https://verification.didit.me/v3/businesses/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "status=ACTIVE" \
  --data-urlencode "country_code=GBR" \
  --data-urlencode "page_size=50"

企業の取得

GET /v3/businesses/{vendor_data}/ vendor_dataを指定して1件の企業を取得します。

curl https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY"

企業の作成

POST /v3/businesses/create/ 法人確認 (KYB)セッションを実行する前に、企業を事前に作成します：

curl -X POST https://verification.didit.me/v3/businesses/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "biz-acme",
    "display_name": "Acme Corp",
    "country_code": "GBR",
    "metadata": { "partner": "Acme Holdings" }
  }'

同じvendor_dataの企業がすでに存在する場合は、競合エラーを返します。既存の企業を更新するにはPATCHを使用してください。

企業の更新

PATCH /v3/businesses/{vendor_data}/ 変更可能なプロフィールフィールドを更新します。法人登記の照会から得られたフィールド（legal_name、registration_number、country_code）は検証後は読み取り専用ですが、上書きは可能です。上書きした内容は監査ログでフラグ付けされます。 変更可能なフィールド：display_name、metadata、tags。 検証後に読み取り専用となるもの：法人登記から得られたすべてのフィールド、集計カウンター、featuresマップ。

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "tier": "enterprise" } }'

business.data.updatedを発行します。

ステータスの変更

PATCH /v3/businesses/{vendor_data}/update-status/ 企業のステータスをACTIVE、FLAGGED、BLOCKEDの間で変更します。

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/update-status/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "BLOCKED",
    "reason": "Sanctioned subsidiary detected in ownership chain"
  }'

変更前 → 変更後	主なトリガー
`ACTIVE` → `FLAGGED`	法人確認 (KYB)セッションが`In Review`に移行、継続的なAMLモニタリングでのヒット、取引ルール
`ACTIVE` → `BLOCKED`	自動ブロックを伴う法人確認 (KYB)セッションの`Declined`、制裁対象エンティティであることの確定
`FLAGGED` → `ACTIVE`	アナリストがレビューで問題なしと判断
`BLOCKED` → `ACTIVE`	是正後の手動によるブロック解除

business.status.updatedを発行します。

企業の削除 (一括)

POST /v3/businesses/delete/ 1件以上の企業を削除します。企業レコードは完全に削除されます。このエンドポイントは検証セッションを対象としないため、セッションは企業との紐付けが解除された状態で残ります。セッションはDelete Sessionで削除してください。取引も対象外です。取引はConsoleから削除してください。

curl -X POST https://verification.didit.me/v3/businesses/delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vendor_data": ["biz-acme", "biz-alpha", "biz-beta"] }'

冪等です。すでに削除された企業を削除しても何も起こりません。

権限モデル

/v3/businesses/*のすべてのエンドポイントへのアクセスは、businesses権限リソースによって制御されます：

役割	list	get	create	update	update-status	delete
OWNER	✅	✅	✅	✅	✅	✅
ADMIN	✅	✅	✅	✅	✅	✅
COMPLIANCE_OFFICER	✅	✅	❌	✅	✅	❌
DEVELOPER	✅	✅	✅	❌	❌	❌
READER	✅	✅	❌	❌	❌	❌

役割と権限を参照してください。

これらの操作で送信されるWebhook

操作	Webhook
`create`	`business.data.updated`
`update`	`changed_fields`を含む`business.data.updated`
`update-status`	`business.status.updated`
`delete`	`deleted_at`が設定された`business.data.updated`

次のステップ

データモデル

全フィールドのリファレンス。

一覧取得API

GET /v3/businesses/のスキーマ。

作成API

POST /v3/businesses/create/のスキーマ。

最終更新日 2026年11月1日

概要

料金

ワークフローと検証

レビューと運用

エンティティ（ユーザーと法人）

設定とカスタマイズ

セキュリティとコンプライアンス

Didit Academy

リソース

企業(KYB)のCRUD操作:作成・一覧・更新・削除

企業の一覧取得

企業の取得

企業の作成

企業の更新

ステータスの変更

企業の削除 (一括)

権限モデル

これらの操作で送信されるWebhook

次のステップ

データモデル

一覧取得API

作成API

​企業の一覧取得

​企業の取得

​企業の作成

​企業の更新

​ステータスの変更

​企業の削除 (一括)

​権限モデル

​これらの操作で送信されるWebhook

​次のステップ

データモデル

一覧取得API

作成API

企業の一覧取得

企業の取得

企業の作成

企業の更新

ステータスの変更

企業の削除 (一括)

権限モデル

これらの操作で送信されるWebhook

次のステップ