> ## 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.

# ユーザー書類：身分証明書・住所証明・補足ファイル

> DiditのUserエンティティに保存される身分証明書、住所証明書類、補足ファイルについて、収集される内容、取得方法、コンソールからのアップロード方法を解説します。



ユーザー書類用プロンプト
        プロンプトをクリップボードにコピー



      
      

\<pre>

\````# Goal — retrieve user documents and generate compliance PDFs

Documents (ID images, MRZ data, selfies, proof-of-address scans, NFC chip reads) are attached to the **session** that captured them, not directly to the User entity. There is no public "upload document to user" API — capture flows through sessions. You can however list sessions for the user, retrieve each session's decision, and pull signed URLs to the document images.

\## Pattern — list sessions for a user, then read each decision

\```bash
\# 1) List sessions tied to the User entity
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "vendor_data=user-42" \
\--data-urlencode "page_size=50"

\# 2) For each session, retrieve the full decision (V3 plural arrays)
curl https://verification.didit.me/v3/session/$SESSION_ID/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
\```

\## Where documents appear in the V3 decision

Inspect these plural arrays (every per-feature result is plural in V3):

\| Array | Contains |
\|---|---|
\| `id_verifications[]` | Government ID images, OCR fields, MRZ, expiry, issuing country |
\| `liveness_checks[]` | Selfie frames, passive liveness score |
\| `nfc_verifications[]` | NFC chip data, ICAO certificate chain |
\| `proof_of_address_checks[]` | POA document images, extracted address |

Image URLs are short-lived signed URLs — cache the bytes if you need them long-term, or re-fetch the decision when they expire.

\## Generate a PDF report

For a human-readable compliance export (used for SARs, audits, regulator requests):

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

The PDF includes session details, per-feature results, and embedded document images.

\## Re-verification / new document collection

To collect fresh documents (e.g. expired ID), create a new session for the same `vendor_data` — the new session attaches to the existing User 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": "$WORKFLOW_ID", "vendor_data": "user-42"}'
\```

\## Failure modes

\- `404` — wrong `session_id` or wrong `vendor_data` casing.
\- Expired signed image URL — re-fetch the decision to get fresh URLs.
\- `403` on PDF — your API key's role lacks PDF export permission.
\- Document monitoring is on by default and sends no warning before a document expires: when the ID's expiry date passes, the Approved session moves to "Kyc Expired" — see /core-technology/id-verification/document-monitoring-id-verification.

\## Response shape

See /reference/data-models for the full per-feature schema. Each plural-array item carries its own `status`, `document_images[]`, OCR extract, and decision metadata.

\## Sources of truth

\- /sessions-api/retrieve-session — decision schema
\- /reference/data-models — V3 plural-array contract
\- /core-technology/id-verification/overview — ID capture behaviour
\- /core-technology/proof-of-address/overview — POA capture
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

貼り付け先

ユーザーが認証中にアップロードしたすべての書類は、そのユーザーのUserエンティティに恒久的に紐付けられます。このページでは、収集される内容、その取得方法、追加書類を手動でアップロードする方法を説明します。## Didit が収集する書類| 書類の種類 | 収集タイミング | 抽出されるフィールド |
| - | - | - |
| **政府発行の身分証明書**（パスポート、国民IDカード、運転免許証、在留許可証） | [本人確認](https://docs.didit.me/ja/core-technology/id-verification/overview.md)ステップ | 氏名、生年月日、書類番号、発行国、有効期限、MRZ（ある場合） |
| **セルフィー / ライブネスフレーム** | [ライブネス](https://docs.didit.me/ja/core-technology/liveness/overview.md)ステップ | 最も大きい顔の切り抜き画像、パッシブライブネススコア |
| **住所証明（POA）** | [POA](https://docs.didit.me/ja/core-technology/proof-of-address/overview.md)ステップ | 氏名、住所、発行元、書類の日付 |
| **NFCチップの読み取り** | [NFC認証](https://docs.didit.me/ja/core-technology/nfc-verification/overview.md)ステップ | チップデータ、ICAO証明書チェーン、OCRとの照合 |
| **追加書類** | アナリストからの依頼またはカスタムワークフローのステップ | 該当する場合はOCR、それ以外はそのまま保存 |[対応書類の種類](https://docs.didit.me/ja/core-technology/id-verification/supported-documents-id-verification.md)では、国と書類の組み合わせ一覧（220+の国で14,000+の書類）を確認できます。## 書類の取得書類はユーザーに直接ではなく、その書類を収集した**セッション**に紐付けられます。ユーザーのすべての書類を一覧表示するには、次の手順に従います。**1. ユーザーのセッションを一覧表示する**```bash theme={null}
curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"
```**2. 各セッションの判定を取得する**各セッションの判定には、収集された書類のURLが含まれます。```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```レスポンス内の`id_verification.document_images`、`proof_of_address.document_images`、`liveness.images`フィールドを確認してください。**3. 署名付きURLを使用する**レスポンス内の画像URLは、有効期間の短い署名付きURLです。使用する間はクライアント側でキャッシュするか、有効期限が切れたら判定を再取得してください。## PDFレポートの生成セッションで収集されたすべての内容（すべての書類を含む）を人が読める形式でエクスポートするには、次を使用します。**`GET /v3/session/{session_id}/generate-pdf/`**セッションの詳細、機能ごとの結果、埋め込まれた書類画像を含むPDFを返します。コンプライアンス監査、SARへの添付、規制当局への提出に役立ちます。## コンソールからの書類のアップロードコンプライアンス担当者は、ユーザーまたは進行中のセッションに対して追加書類をアップロードできます。1. *Users → \[user] → Documents → Upload document*に移動します。
2. 書類の種類（ID、POA、カスタム）を選択します。
3. ファイルをアップロードします。対応している種類ではOCRが自動的に実行されます。
4. 書類は最新のセッションに添付されます（是正用のセッションを作成することもできます）。> [!NOTE]
>
> 書類のアップロードUIはコンソール専用です。ユーザーに書類を直接添付するための公開APIエンドポイントはありません。すべての書類の取り込みでは、セッションを起点として使用してください。## 書類の相互照合1つのセッションで複数の種類の書類を収集した場合、Diditはそれらを相互に照合します。- **ID ↔ ライブネス**：IDの顔がライブネスのセルフィーと一致します。
- **ID ↔ POA**：POA上の氏名がIDから抽出された氏名と一致します。
- **ID ↔ NFC**：MRZ / 券面の情報がNFCチップのデータと一致します。不整合はセッションの判定結果に警告として表示され、手動レビューをトリガーするよう設定できます。## 書類のモニタリングと再検証書類の有効性を継続的に確認する必要があるユースケース（期限切れのIDなど）の場合：- **書類の有効期限**は、認証済みのすべてのIDで追跡されます。セッションの判定の`expiration_date`フィールドを照会してください。
- **書類のモニタリング**：デフォルトで有効かつ自動で、何も有効化する必要はありません。IDの有効期限が過ぎると、`"Approved"`のセッションは`"Kyc Expired"`に移行し、本人確認の結果に`DOCUMENT_EXPIRED`の警告が追加され、`status.updated` Webhookが送信されます。期限が過ぎる前に警告が送信されることはありません。
- **無効にする方法**：[本人確認の設定](https://docs.didit.me/ja/core-technology/id-verification/overview.md)で、該当する国と書類の種類について**Expiration mode**を**Allow expired**に設定します。デフォルトの**Reject expired**がモニタリングを行うモードです。**Allow expired**として受け付けられた書類は、一切モニタリングされません。
- **再検証**：同じ`vendor_data`に対して新しいセッションをトリガーし、書類を更新します。## 書類のジオロケーション[ID書類のジオロケーション](https://docs.didit.me/ja/core-technology/id-verification/document-geolocation-id-verification.md)チェックでは、提出者のIP位置情報とIDの発行国を比較します。結果はセッションの判定に追加されます。## プライバシーと保持- すべての書類は保存時に暗号化されます。
- 画像へのアクセスは、有効期間の短い署名付きURLを介して行われます。
- 保持期間はアプリケーションの[データ保持](https://docs.didit.me/ja/console/data-retention.md)ポリシーに従います。
- ユーザーには削除を要求する権利があり、削除すると画像、OCRの抽出データ、NFCデータが削除されます。## 次のステップ> [card] [本人確認](https://docs.didit.me/ja/core-technology/id-verification/overview.md)
>
> IDの撮影とOCRの仕組み。> [card] [住所証明](https://docs.didit.me/ja/core-technology/proof-of-address/overview.md)
>
> POA書類の収集。> [card] [セッションの判定](https://docs.didit.me/ja/sessions-api/retrieve-session.md)
>
> GET /v3/session/{id}/decision/ のリファレンス。


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