> ## 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の住所証明レポートを解析し、抽出された住所、書類の種類、発行元、日付、氏名の一致スコア、PDFオーバーレイ改ざんの証拠、警告を確認できます。 ## 概要 住所証明(POA)の検証では、最大15MBのPDFまたは画像(TIFF、JPG、JPEG、PNG、WEBP、ZIP圧縮も可)を1件受け付けます。書類タイプの分類、LLMによる抽出、PDF/EXIFフォレンジックを実行し、以下を返します。 * **抽出された住所**: 未加工の住所と、構造化された住所(`street_1`、`city`、`region`、`postal_code`、緯度/経度)の両方。 * **書類メタデータ**: ファイルサイズ、コンテンツタイプ、作成日と更新日、EXIFの日付、署名情報、およびPDFフォレンジックで検出されたオーバーレイ改ざんの証拠。 * **氏名の一致スコア**: 検証済みの本人確認書類との比較結果と、セッション作成時に指定された期待値との比較結果。 * **銀行関連の追加フィールド**(口座番号、IBAN、ソートコード、ルーティング番号、SWIFT/BIC、支店): 書類が銀行取引明細書の場合に返されます。 ![抽出された住所フィールドと書類タイプを示すDiditの住所証明レポートのスクリーンショット](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/proof-of-address-report.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=099d1bd6cf0c215cc93c3a504b8aa9ee) > [!NOTE] > > POAの抽出では非構造化テキストの読み取りを行うため、書類1件あたり**5〜15秒**のレイテンシが発生します。Webhookはワークフローのステップ全体が完了したときにのみ送信されます。この間、判定エンドポイントを5秒より短い間隔でポーリングしないでください。 ## APIレスポンスでの表示位置 判定エンドポイントは、`GET /v3/session/{sessionId}/decision/`でPOAを配列**`poa_verifications[]`**として返します。各エントリは、ワークフロー内のPOAノードの1回の実行に対応します。複数のPOAステップ(例: 銀行取引明細書と公共料金の請求書)を含むセッションでは、実行ごとに1件のエントリが生成され、それぞれが独自の`node_id`を持ちます。 ```text theme={null} GET /v3/session/{sessionId}/decision/ ──▶ { "poa_verifications": [ { node_id, status, document_type, poa_address, … }, … ] } ``` 以下の構造は正規スキーマと同じです。[データモデル](https://docs.didit.me/ja/reference/data-models.md#住所証明)を参照してください。 ## スキーマ 正式なスキーマについては、[データモデルリファレンスの住所証明](https://docs.didit.me/ja/reference/data-models.md#住所証明)を参照してください。 ```typescript theme={null} interface POAV3 { status: 'Not Finished' | 'Approved' | 'Declined' | 'In Review'; node_id: string | null; issuing_state: string | null; // ISO 3166-1 alpha-3 document_type: // never null — falls back to 'UNKNOWN' | 'UTILITY_BILL' | 'BANK_STATEMENT' | 'GOVERNMENT_ISSUED_DOCUMENT' | 'OTHER_POA_DOCUMENT' | 'UNKNOWN'; document_subtype: string; // e.g. 'ELECTRICITY_BILL', 'ACCOUNT_STATEMENT'; // never null — falls back to 'UNKNOWN' issuer: string | null; issue_date: string | null; // YYYY-MM-DD expiration_date: string | null; // YYYY-MM-DD when present // Extracted address poa_address: string | null; // raw, single-line poa_formatted_address: string | null; // geocoded/formatted poa_parsed_address: { address_type?: string; street_1?: string; street_2?: string; city?: string; region?: string; postal_code?: string; country?: string; // ISO 3166-1 alpha-2 raw_results?: object; document_location?: { latitude: number; longitude: number }; } | null; document_file: string | null; // presigned URL, expires after ~4 hours document_language: string | null; // ISO 639-1, e.g. 'en' name_on_document: string | null; // Expected details (when supplied at session creation) expected_details_address: string | null; expected_details_formatted_address: string | null; expected_details_parsed_address: object | null; // Match scores (float, 0-100) name_match_score_expected_details: number | null; name_match_score_id_verification: number | null; // PDF + image forensics document_metadata: { file_size: number | null; content_type: string | null; creation_date: string | null; modified_date: string | null; creator: string | null; producer: string | null; software: string | null; encryption: string | null; is_signed: boolean | null; is_tampered: boolean | null; signature_info: object | null; exif_original_date: string | null; exif_digitized_date: string | null; processed_by_known_editor: boolean | string | null; has_different_creation_mod_date: boolean | null; overlay_manipulation: { detected: boolean; analyzed: boolean; signals: string[]; // 'duplicate_font_subset', 'glyph_fragmentation' duplicate_font_subsets: object[]; fragmented_fonts: object[]; manipulated_regions: { page: number; x: number; y: number; width: number; height: number; page_width: number; page_height: number; }[]; } | null; // null for non-PDF uploads or when not analyzed } | null; // Bank-related and custom fields extra_fields: { bank_account_number: string | null; bank_iban: string | null; bank_sort_code: string | null; bank_routing_number: string | null; bank_swift_bic: string | null; bank_branch_name: string | null; bank_branch_address: string | null; document_phone_number: string | null; additional_names: string[]; [customField: string]: unknown; }; extra_files: string[]; // presigned URLs for additional uploaded files // QR codes and barcodes detected_codes: { type: string; // 'QR_CODE', 'CODE_128', 'EAN_13', 'DATA_MATRIX', 'PDF_417', … page_number: number; // 1-based position: [number, number][] | null; x: number | null; y: number | null; width: number | null; height: number | null; page_width: number; page_height: number; raw_payload: string; // base64, empty string when unavailable parsed_payload: unknown | null; // null when located but undecodable }[]; warnings: Warning[]; // see Data Models — Warning object } ``` `warnings[]`の各エントリは[Warningオブジェクト](https://docs.didit.me/ja/reference/data-models.md#警告オブジェクト)で、構造は`{ feature, risk, additional_data, log_type, short_description, long_description, node_id }`です。このレポートでは、`feature`は常に`"PROOF_OF_ADDRESS"`です。 ## ステータス値 `status`には機能レベルのステータス列挙型(`FeatureStatusChoices`)が使用されます。 | 値 | 意味 | | - | - | | `Not Finished` | このセッションでPOAノードがまだ完了していません(デフォルトの状態)。 | | `Approved` | 書類が問題なく解析され、却下またはレビューとなった警告はありません。 | | `In Review` | ワークフローで**レビュー**に設定された設定可能な警告が少なくとも1件発生しています(却下に該当するものはありません)。 | | `Declined` | 必ず却下となる警告(`MISSING_ADDRESS_INFORMATION`、`POA_DOCUMENT_EXPIRED`、`INVALID_DOCUMENT_TYPE`、`UNABLE_TO_VALIDATE_DOCUMENT_AGE`)が発生したか、ワークフローで**却下**に設定された設定可能な警告が発生しました。 | ワークフローノードで設定したカスタムステータスルールにより、算出されたステータスをさらに調整できます。ルールはDeclined > In Review > Approvedの優先順位で組み合わされます。`FUTURE_ISSUE_DATE`のワークフロー限定の再試行動作を含め、リスクとアクションの対応関係の全体については[住所証明の警告](https://docs.didit.me/ja/core-technology/proof-of-address/warnings-proof-of-address.md)を参照してください。 ## PDFオーバーレイ改ざんの証拠 提出された書類がPDFの場合、`document_metadata.overlay_manipulation`には、テキストのオーバーレイが疑われることを示すフォレンジック証拠が含まれる場合があります。 * `detected`: チェックで改ざんの証拠が見つかった場合は`true`。 * `analyzed`: PDFをそもそも解析できた場合は`true`。 * `signals`: 検出されたチェック(`duplicate_font_subset`、`glyph_fragmentation`)。 * `manipulated_regions`: 編集が疑われるテキストを囲む、ページ座標上の矩形。各矩形はPDFページの座標空間(`x`、`y`、`width`、`height`、`page_width`、`page_height`)を使用するため、レビュアーはPDFプレビューで該当箇所をハイライト表示できます。 書類がPDFでない場合、またはPDFを解析できなかった場合、このフィールドは`null`になります。`detected=true`の場合、システムは`SUSPECTED_DOCUMENT_MANIPULATION`警告も発行し、その`additional_data`には上記のシグナルと矩形が反映されます。ただし、より強いシグナル(電子署名後の改変、`is_tampered=true`)が優先された場合は、`additional_data`には代わりに署名の改ざん内容が記述されます。 ## QRコードとバーコード すべてのPOAレポートには、処理されたすべてのページを対象とする`detected_codes`が含まれます。各項目には以下が含まれます。 | フィールド | 説明 | | - | - | | `type` | 検出されたシンボロジー(`QR_CODE`、`CODE_128`、`EAN_13`、`DATA_MATRIX`、`PDF_417`など) | | `page_number` | 1から始まるページ番号 | | `position` | レンダリングされたページのピクセル単位で検出された多角形。信頼できる位置が得られない場合は`null` | | `x`, `y`, `width`, `height` | レンダリングされたページのピクセル単位のバウンディングボックス。信頼できる位置が得られない場合は`null` | | `page_width`, `page_height` | 座標の基準となる、レンダリングされたページの寸法 | | `parsed_payload` | デコードされた文字列または構造化された値。コードの位置しか特定できない場合は`null` | | `raw_payload` | 利用可能な場合は、base64文字列としての未加工のデコーダーペイロード。それ以外の場合は空文字列 | サポートされているコードが見つからない場合、`detected_codes`は空の配列になります。Diditがペイロードを推測することはありません。損傷したコードや読み取れないコードは、位置と`parsed_payload: null`とともに返される場合があります。また、コード検出に失敗してもPOA検証は失敗しません。 ## 例 ### 銀行取引明細書が承認済みになる例 ```json theme={null} { "poa_verifications": [ { "status": "Approved", "node_id": "feature_poa_1", "issuing_state": "USA", "document_type": "BANK_STATEMENT", "document_subtype": "ACCOUNT_STATEMENT", "issuer": "National Bank", "issue_date": "2026-04-15", "expiration_date": null, "document_language": "en", "name_on_document": "John A. Smith", "poa_address": "123 Main St, Apartment 4B, New York, NY 10001", "poa_formatted_address": "123 Main St, Apartment 4B, New York, NY 10001, USA", "poa_parsed_address": { "address_type": "Street", "street_1": "123 Main St", "street_2": "Apartment 4B", "city": "New York", "region": "NY", "postal_code": "10001", "country": "US", "document_location": { "latitude": 40.7128, "longitude": -74.0060 } }, "document_file": "https:///.../poa.pdf?X-Amz-Expires=14400", "document_metadata": { "file_size": 246810, "content_type": "application/pdf", "creation_date": "2026-04-15", "modified_date": "2026-04-15", "creator": "PDFKit", "producer": "Quartz", "software": null, "encryption": null, "is_signed": false, "is_tampered": false, "signature_info": null, "exif_original_date": null, "exif_digitized_date": null, "processed_by_known_editor": false, "has_different_creation_mod_date": false, "overlay_manipulation": null }, "name_match_score_expected_details": 100, "name_match_score_id_verification": 98, "expected_details_address": null, "expected_details_formatted_address": null, "expected_details_parsed_address": null, "extra_fields": { "bank_account_number": "****1234", "bank_iban": null, "bank_sort_code": null, "bank_routing_number": "021000089", "bank_swift_bic": "NABNUS33", "bank_branch_name": "Manhattan Midtown", "bank_branch_address": "111 Wall St, New York, NY", "document_phone_number": null, "additional_names": [] }, "extra_files": [], "detected_codes": [ { "type": "QR_CODE", "page_number": 1, "position": [[820, 1120], [1002, 1120], [1002, 1302], [820, 1302]], "x": 820, "y": 1120, "width": 182, "height": 182, "page_width": 1190, "page_height": 1684, "raw_payload": "aHR0cHM6Ly9uYXRpb25hbGJhbmsuZXhhbXBsZS9zdG10Lzk5ODE=", "parsed_payload": "https://nationalbank.example/stmt/9981" }, { "type": "CODE_128", "page_number": 1, "position": [[112, 1480], [560, 1480], [560, 1540], [112, 1540]], "x": 112, "y": 1480, "width": 448, "height": 60, "page_width": 1190, "page_height": 1684, "raw_payload": "MDAxMjM0NTY3ODk=", "parsed_payload": "001234567 89" } ], "warnings": [] } ] } ``` ### オーバーレイ改ざんと氏名の不一致で却下される例 ```json theme={null} { "poa_verifications": [ { "status": "Declined", "node_id": "feature_poa_1", "issuing_state": "GBR", "document_type": "UTILITY_BILL", "document_subtype": "ELECTRICITY_BILL", "issuer": "BritishEnergy", "issue_date": "2026-03-10", "expiration_date": null, "document_language": "en", "name_on_document": "JOHN B SMYTH", "poa_address": "44 King's Road, London, SW3 4UD", "poa_formatted_address": "44 King's Road, London, SW3 4UD, United Kingdom", "poa_parsed_address": { "street_1": "44 King's Road", "city": "London", "postal_code": "SW3 4UD", "country": "GB", "document_location": { "latitude": 51.4880, "longitude": -0.1690 } }, "document_file": "https:///.../poa.pdf?X-Amz-Expires=14400", "document_metadata": { "file_size": 412910, "content_type": "application/pdf", "creation_date": "2026-03-10", "modified_date": "2026-05-12", "creator": "Adobe Acrobat Pro", "producer": "Adobe PDF Library", "software": "Adobe Acrobat", "encryption": null, "is_signed": false, "is_tampered": false, "signature_info": null, "exif_original_date": null, "exif_digitized_date": null, "processed_by_known_editor": false, "has_different_creation_mod_date": true, "overlay_manipulation": { "detected": true, "analyzed": true, "signals": ["duplicate_font_subset", "glyph_fragmentation"], "duplicate_font_subsets": [{ "page": 1, "base_font": "Helvetica" }], "fragmented_fonts": [], "manipulated_regions": [ { "page": 1, "x": 102.4, "y": 318.1, "width": 187.0, "height": 18.0, "page_width": 595, "page_height": 842 } ] } }, "name_match_score_expected_details": 62, "name_match_score_id_verification": 60, "expected_details_address": null, "expected_details_formatted_address": null, "expected_details_parsed_address": null, "extra_fields": { "bank_account_number": null, "bank_iban": null, "bank_sort_code": null, "bank_routing_number": null, "bank_swift_bic": null, "bank_branch_name": null, "bank_branch_address": null, "document_phone_number": null, "additional_names": [] }, "extra_files": [], "detected_codes": [], "warnings": [ { "feature": "PROOF_OF_ADDRESS", "risk": "SUSPECTED_DOCUMENT_MANIPULATION", "additional_data": { "reason": "Overlay-text manipulation detected: same base font embedded with multiple subset prefixes on 1 page(s).", "detection_method": "overlay_text_manipulation", "signals": ["duplicate_font_subset", "glyph_fragmentation"], "duplicate_font_subsets": [{ "page": 1, "base_font": "Helvetica" }], "fragmented_fonts": [], "manipulated_regions": [ { "page": 1, "x": 102.4, "y": 318.1, "width": 187.0, "height": 18.0, "page_width": 595, "page_height": 842 } ] }, "log_type": "error", "short_description": "Suspected document manipulation", "long_description": "The system detected signs of potential document manipulation or editing.", "node_id": "feature_poa_1" }, { "feature": "PROOF_OF_ADDRESS", "risk": "NAME_MISMATCH_ID_VERIFICATION", "additional_data": { "poa_name": "JOHN B SMYTH", "kyc_name": "John A. Smith", "match_score": 60 }, "log_type": "warning", "short_description": "Name mismatch with ID verification", "long_description": "The full name on the document does not match the name from the user's verified identity documents.", "node_id": "feature_poa_1" } ] } ] } ``` ## 関連情報 * [住所証明の警告](https://docs.didit.me/ja/core-technology/proof-of-address/warnings-proof-of-address.md): POAが発行しうるすべての警告コード * [住所証明の概要](https://docs.didit.me/ja/core-technology/proof-of-address/overview.md): 受け付ける書類タイプと検証ルール * [データモデル: 住所証明](https://docs.didit.me/ja/reference/data-models.md#住所証明): 正式なスキーマ * [Webhook](https://docs.didit.me/ja/integration/webhooks.md): `status.updated`はPOAのペイロードを含みます > [!NOTE] > > `document_file`と`extra_files[]`は、約4時間で期限切れになる署名付きURLです。URLを更新するには、判定エンドポイントを再度呼び出してください。自社側には検証ステータスと解析済みの住所フィールドのみを保存し、保持する書類データは最小限に抑えてください。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.