> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 企業のKYB履歴：セッションとレポート

> Didit の企業エンティティに紐づくすべてのKYBセッションを取得し、法人登記データやAMLヒットを確認、再検証をトリガーしてコンプライアンスレポートを生成できます。



KYB履歴プロンプト
        プロンプトをクリップボードにコピー



      
      

\<pre>

\````# Goal — read a business's full KYB history and trigger re-verification

Every KYB session is linked to the Business entity via `vendor_data`. List sessions, retrieve each decision, and create new sessions for re-KYB.

\## List every KYB session for a business

\```bash
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=biz-acme" \
\--data-urlencode "page_size=50"
\```

KYB session payloads carry `session_kind: "business"` and `business_session_id` to distinguish them from KYC sessions.

\## Inspect a single KYB decision

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

KYB decisions include:

\- Company registry data (legal name, registration, status, incorporation date, addresses)
\- `key_people_checks[]` — UBOs, shareholders, directors, officers (registry-sourced and user-submitted, with role tags)
\- `aml_screenings[]` — company AML and per-person AML
\- `document_verifications[]` — uploaded docs with OCR extracts and signed image URLs

See /business-verification/response-schema for the full payload.

\## Fast path — fully verified right now?

\```bash
curl https://verification.didit.me/v3/businesses/biz-acme/ \
-H "x-api-key: $DIDIT_API_KEY"
\# data.features = { KYB: "Approved" }
\```

The Business entity's `features` map holds the latest company verification status under the `KYB` key.

\## Trigger re-KYB

Annual re-KYB or trigger-based re-checks: create a new session against the same `vendor_data`. The new session attaches to the existing Business entity.

\```bash
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id": "wf_kyb_annual", "vendor_data": "biz-acme"}'
\```

\## Generate a KYB PDF report

\```bash
curl https://verification.didit.me/v3/session/$SESSION_ID/generate-pdf/ \
-H "x-api-key: $DIDIT_API_KEY" \
-o kyb-report.pdf
\```

PDF covers registry data, ownership structure, AML hits, document images, per-officer KYC status, questionnaires, phone verification, email verification, and IP analysis when those features are part of the workflow.

\## Resubmit vs new session

\| Scenario | Use |
\|---|---|
\| Registry needs corrected company name | Resubmit — analyst edits data and re-runs registry |
\| Additional document requested | Resubmit — business uploads the missing document |
\| Annual / trigger-based re-KYB | Create a brand new session |

\`kyb_key_people` and `kyb_registry` cannot be resubmitted directly — to re-verify a person, resubmit their child KYC session; the parent Key People feature re-aggregates automatically.

\## Share a session

\```bash
curl -X POST https://verification.didit.me/v3/session/$SESSION_ID/share/ \
-H "x-api-key: $DIDIT_API_KEY"

curl -X POST https://verification.didit.me/v3/session/import-shared/ \
-H "x-api-key: $RECEIVER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"share_token": "..."}'
\```

\## Failure modes

\- `404` — wrong `vendor_data` casing or no KYB sessions yet.
\- Stale signed image URLs — re-fetch the decision.
\- `session_kind: "user"` events in the same list — filter on `session_kind === "business"` for KYB-only handling.

\## Sources of truth

\- /business-verification/response-schema — full KYB decision payload
\- /business-verification/statuses — feature state machine
\- /entities/businesses/data-model — features map computation
\- /core-technology/reusable-kyc/overview — share / import pattern
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

貼り付け先

Businessに対して実行されたすべての法人確認 (KYB) セッションは、Businessエンティティに永続的に紐づけられます。全履歴の取得、各セッションの法人登記データとAMLヒットの確認、再検証のトリガー、監査用のPDFレポートの生成が可能です。## 企業の法人確認 (KYB) セッションを一覧表示するSessions リストを`vendor_data`でフィルターします。```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"
```レスポンスには、すべての法人確認 (KYB) セッションが含まれます（ステータスは問いません）。## KYBの機能を理解するKYBセッションでは以下の機能が実行され、それぞれがセッションの判定内で個別のステータスを持ちます。| 機能 | 対象範囲 |
| - | - |
| `KYB_REGISTRY` | 法人登記の照会。存在、ステータス、識別情報の照合 |
| `AML` | 企業レベルのAMLスクリーニング(制裁、ネガティブメディア、ウォッチリスト) |
| `KYB_DOCUMENTS` | 書類の収集とOCRによる相互照合 |
| `KYB_KEY_PEOPLE` | 役員、UBO、実質的支配者。本人特定と任意のKYC |企業エンティティの`features`マップには、最新の企業検証ステータスのみが保持されます。```json theme={null}
"features": {
  "KYB": "Approved"
}
```詳しくは[KYB機能のステータス](https://docs.didit.me/ja/business-verification/statuses.md)のリファレンスを参照してください。## 単一の法人確認 (KYB) セッションを確認する```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```KYBの判定には以下が含まれます。- 法人登記データ(正式名称、登記情報、ステータス、設立日、住所)
- 法人登記から抽出された役員とUBO
- 所有構造(資本構成表、実質的支配の持分割合)
- 企業のAML結果(ヒット、スコア)
- 各UBOおよび役員に対する個人ごとのAML結果
- OCR抽出結果を含む書類の結果
- 判定理由コードペイロードの全体については[KYBレスポンススキーマ](https://docs.didit.me/ja/business-verification/response-schema.md)を参照してください。## 再検証をトリガーする年次の再KYB、トリガーに基づく再チェック、是正フローは、いずれも新しいセッションから開始します。```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_kyb_annual",
    "vendor_data": "biz-acme"
  }'
```新しいセッションは既存のBusinessエンティティに紐づけられ、完了時に`features`マップを更新します。## 再提出と新しい法人確認 (KYB) セッションの違い| シナリオ | 使用する方法 |
| - | - |
| 法人登記の照会で企業名の修正が必要な場合 | 再提出。アナリストがデータを編集し、法人登記の照会を再実行します |
| 企業に追加の書類を依頼する場合 | 再提出。企業が不足している書類をアップロードします |
| 年次またはトリガーに基づく再KYB | 新しいセッションを作成します |## KYBレポートをエクスポートする任意の法人確認 (KYB) セッションについて、包括的なPDFを生成できます。```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/generate-pdf/ \
  -H "x-api-key: YOUR_API_KEY" \
  -o kyb-report.pdf
```PDFには、法人登記データ、所有構造、AMLヒット、書類の画像、役員のKYCステータス、および判定理由を記載した表紙が含まれます。## 法人確認 (KYB) セッションを共有するコンソーシアムやパートナーとのワークフローの場合:- `POST /v3/session/{session_id}/share/`: 共有可能なトークンを生成します。
- `POST /v3/session/import-shared/`: 受信側でインポートします。## 継続的なモニタリング継続的なモニタリングモードのBusinessエンティティでは、定期的にAMLの再スキャンが行われます。新たな制裁またはネガティブメディアのヒットが検出されると、企業のAMLスクリーニングが更新されます。セッションの判定の`aml_screenings[]`から確認してください。継続的なモニタリングは、コンソールの*Workflows → \[KYBワークフロー] → AML → Ongoing monitoring*で設定します。## 次のステップ> [card] [KYBの概要](https://docs.didit.me/ja/business-verification/overview.md)
>
> 法人確認 (KYB) セッションの開始から完了までの流れ。> [card] [KYBレスポンス](https://docs.didit.me/ja/business-verification/response-schema.md)
>
> 判定ペイロードの完全なリファレンス。> [card] [主要人物](https://docs.didit.me/ja/entities/businesses/key-people.md)
>
> 役員、UBO、関連付けられたユーザー。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.