企業データモデル：KYBスキーマ

このページでは、Businessエンティティのすべてのフィールドと、Diditが各フィールドに値を設定する方法を説明します。

識別フィールド

フィールド	型	説明
`uuid`	UUID	Diditが割り当てる主キーです。不変かつ一意です。
`didit_internal_id`	string	人が読める形式の内部識別子です。
`vendor_data`	string	お客様が企業に付ける識別子です。アプリケーションごとに一意です。詳細はこちら。
`display_name`	string	コンソールに表示される上書き用の名前です。デフォルトは`legal_name`または`vendor_data`です。
`legal_name`	string	登記上の正式な会社名です。最新の承認済み法人確認 (KYB) セッションの登記照会から反映されます。
`registration_number`	string	公式の法人登記番号です。登記から反映されます。
`country_code`	string (ISO 3166-1 alpha-3)	設立国です。

legal_name、registration_number、country_codeは、検証済みの登記照会から取得された場合は読み取り専用です。コンソールまたはPATCH /v3/businesses/{vendor_data}/で手動で上書きできますが、上書きには監査ログでフラグが付けられます。

ステータス

フィールド	型	値	説明
`status`	enum	`ACTIVE`、`FLAGGED`、`BLOCKED`	今後のセッションと取引に対する制限の適用を制御します。ライフサイクルを参照してください。

セッション集計フィールド

フィールド	型	説明
`session_count`	int	この企業に対してこれまでに作成された法人確認 (KYB) セッションの総数
`approved_count`	int	`Approved`で完了したセッション数
`declined_count`	int	`Declined`で完了したセッション数
`in_review_count`	int	現在`In Review`のセッション数
`features`	object	`KYB`キーの下に格納される、最新の企業確認ステータス

`features`マップ

{
  "KYB": "Approved"
}

このマップにはKYBというキーが1つだけあり、その企業の最新の確認ステータス ("Not Finished"、"Approved"、"Declined"、"In Review"、"Resub Requested"のいずれか) が格納されます。個々のKYB機能のステータスについては、セッションの判定を参照してください。すべてのセッションを順に確認することなく、企業が現時点で完全に確認済みかどうかをすばやく確認するには、featuresマップを使用してください。

アクティビティのタイムスタンプ

フィールド	型	更新されるタイミング
`first_session_at`	ISO timestamp	最初の法人確認 (KYB) セッションが作成されたとき
`last_session_at`	ISO timestamp	最新のセッションが作成または更新されたとき
`last_activity_at`	ISO timestamp	セッション、取引、ステータス、プロフィール、メモのいずれかに変更があったとき
`created_at`	ISO timestamp	エンティティの行が作成されたとき
`updated_at`	ISO timestamp	エンティティの行が最後に更新されたとき

メタデータ

フィールド	型	説明
`metadata`	object (JSON)	お客様が管理する自由形式のJSON
`tags[]`	array	コンソールまたはAPIで管理するタグ

リレーション (企業の行には保存されません)

リレーション	アクセス方法
法人確認 (KYB) セッション	`GET /v3/sessions?vendor_data=<value>`
紐づくユーザー (役員、UBO、取締役)	コンソールの企業詳細ページに表示されます。最新の承認済み法人確認 (KYB) セッションから取得されます
取引 (申請者または取引相手として)	企業の`vendor_data`で取引をフィルターします
書類	法人確認 (KYB) セッションの判定から取得します
AMLヒット	法人確認 (KYB) セッションの判定から取得します

レスポンスの例

{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}

次のステップ

操作

作成、更新、ステータス変更、削除。

KYB履歴

企業に紐づくすべてのセッションを取得します。

APIリファレンス

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

最終更新日 2026年11月1日

概要

料金

ワークフローと検証

レビューと運用

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

設定とカスタマイズ

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

Didit Academy

リソース

企業データモデル：KYBスキーマ

識別フィールド

ステータス

セッション集計フィールド

`features`マップ

アクティビティのタイムスタンプ

メタデータ

リレーション (企業の行には保存されません)

レスポンスの例

次のステップ

操作

KYB履歴

APIリファレンス

​識別フィールド

​ステータス

​セッション集計フィールド

​featuresマップ

​アクティビティのタイムスタンプ

​メタデータ

​リレーション (企業の行には保存されません)

​レスポンスの例

​次のステップ

操作

KYB履歴

APIリファレンス

識別フィールド

ステータス

セッション集計フィールド

`features`マップ

アクティビティのタイムスタンプ

メタデータ

リレーション (企業の行には保存されません)

レスポンスの例

次のステップ