> ## 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. # 住所証明API：公共料金明細の検証 > Diditの住所証明は、公共料金明細、銀行取引明細書、公的書類からAIで住所を抽出し、居住地住所を検証します。1回$0.20の従量課金です。 住所証明（PoA）検証は、公的な書類を使ってユーザーの居住地住所を検証する機能です。住所確認のプロセスを簡素化し、ユーザーが住所を証明する書類を撮影またはアップロードできるようにします。 住所証明の連携プロンプト Copy prompt to clipboard \

\````# Goal
Integrate Didit Proof of Address (utility bill, bank statement, government letter OCR + cross-checks) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when the user uploads the document in a hosted Didit flow.

1\. Add the PROOF_OF_ADDRESS feature to the workflow (Business Console or POST /v3/workflows/). Configure: poa_languages_allowed, poa_document_age_months, and the per-risk actions (poa_issuer_not_identified_action, poa_name_mismatch_action, poa_address_mismatch_action, poa_document_expired_action, poa_language_not_allowed_action).
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `poa_verifications[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you already have the document and want a one-shot check decoupled from a hosted flow.

POST https://verification.didit.me/v3/poa/
multipart/form-data — x-api-key: YOUR_API_KEY

Latency: OCR typically takes 5–15s (up to ~30s for multi-page PDFs). Use a client timeout of **at least 45s**. Max upload 15 MB (PDF, JPG, PNG, TIFF, WebP). Encrypted PDFs require `document_password` or you get HTTP 400 with `code: "encrypted_pdf"`.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/poa/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F "document=@./utility-bill.pdf" \
-F "expected_address=Av. Monseñor Tavella 3396, Salta" \
-F "expected_country=ARG" \
-F "expected_first_name=Sophia" \
-F "expected_last_name=Martinez" \
-F "poa_languages_allowed=en,es" \
-F "vendor_data=user-1234"
\```
Returns: { request_id, poa: { status, parsed_address, document_type, issuer, issue_date, language, document_metadata: { overlay_manipulation }, warnings: [...] } }.

\# Status enum (per poa_verifications[].status / poa.status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.PROOF_OF_ADDRESS)
warnings[] risk codes include:
ISSUER_NOT_IDENTIFIED, LANGUAGE_NOT_ALLOWED, DOCUMENT_EXPIRED, DOCUMENT_TOO_OLD, NAME_MISMATCH, ADDRESS_MISMATCH, COUNTRY_MISMATCH, OVERLAY_MANIPULATION_DETECTED, UNREADABLE_DOCUMENT.
Full catalogue: /core-technology/proof-of-address/warnings-proof-of-address.

\# Failure modes to handle
\- HTTP 400 with `code: "encrypted_pdf"` — the PDF is password-protected (or the password is wrong); supply the right `document_password` or a decrypted copy.
\- HTTP 400 with `code: "document_unreadable"` — the file is corrupt or cannot be opened; ask the user for a different file. Branch on `code`, not on the message text.
\- HTTP 403 — out of credits.
\- Client timeout — bump to 45s+ before retrying.
\- status="Declined" with NAME_MISMATCH / ADDRESS_MISMATCH — the extracted fields don't match expected_*; do not approve.
\- OVERLAY_MANIPULATION_DETECTED — PDF forensics caught edits; reject.

\# See also
\- Canonical schema: /reference/data-models#proof-of-address
\- Per-feature report: /core-technology/proof-of-address/report-proof-of-address
\- Risk catalogue: /core-technology/proof-of-address/warnings-proof-of-address
\- Full integration playbook: /integration/integration-prompt````

\
Paste into 検証結果の読み方を扱うAcademyのレッスンでは、7:20で住所証明のチェックに到達します。[住所証明 — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## 仕組みDiditの住所証明検証は、公的な書類を通じてユーザーの居住地住所を検証する、堅牢なソリューションです。高度なAI、コンピュータビジョン、包括的なセキュリティチェックを組み合わせ、高速で信頼性の高い住所確認を大規模に提供します。**1. インテリジェントな書類キャプチャ**ユーザーは次の方法で住所を検証できます。| 方法 | 説明 | | - | - | | **自動キャプチャ** | AIが書類の最適な位置を自動的に検出し、最適なタイミングで自動撮影します | | **アップロードオプション** | ユーザーは既存の書類をさまざまな形式（PDF、JPG、PNG）でアップロードできます | | **複数ページ対応** | 銀行取引明細書のような複数ページの書類もスムーズに処理します |**2. 高度なデータ抽出と検証**強力な処理機能を備えています。- 住所情報を抽出する高精度のOCR - 書類の種類を特定するインテリジェントな書類分類 - 本人確認書類との氏名照合による相互検証 - 発行日の抽出と、設定した要件に対する検証 - すべての住所フィールドの形式とパターンの照合**3. 包括的な検証**AIを活用したシステムが、広範なチェックを実行します。| チェック | 説明 | | - | - | | **書類の真正性** | 書類が正規のものかを検証します | | **改ざん検出** | 画像の整合性を解析して、加工を検出します | | **住所の標準化** | 住所フィールドを整形して正規化します | | **ジオコーディング** | 抽出した住所から位置座標を取得します | | **言語検出** | 書類の言語を特定して検証します |**4. スムーズな結果の配信**検証結果は複数のチャネルから確認できます。- リアルタイムのダッシュボード更新 - 即時のWebhook通知 - RESTful APIによる連携 - 検証セッションの詳細情報を含む包括的なレポート## 書類の要件住所確認を確実に成功させるには、書類が次の条件を満たしている必要があります。#### 受け付ける書類の種類次の表は、受け付ける書類の種類とそのサブタイプの一覧です。特に記載がない限り、すべての書類は過去3か月以内に発行されたものである必要があります。| 書類の種類 | サブタイプ | | - | - | | **公共料金明細** | 電気料金明細、水道料金明細、ガス料金明細、インターネット料金明細、電話料金明細、ケーブルテレビ料金明細、衛星放送料金明細、ごみ収集料金明細、下水道料金明細、暖房料金明細、公共料金の合算明細、自治体サービス料金明細 | | **銀行取引明細書** | 口座取引明細書、クレジットカード利用明細書、住所を確認する銀行の書簡、住宅ローン明細書、ローン明細書、普通預金口座の明細書、当座預金口座の明細書、投資口座の明細書、法人口座の明細書、信用組合の明細書、デビットカード利用明細書、与信枠の明細書 | | **公的機関発行の書類** | 税額査定通知、有権者登録カード、身分証明書、居住証明書、政府からの書簡・通知、国勢調査の書簡、個人登録証明書、固定資産税の請求書、車両登録証、社会保障の明細書、失業給付の通知書、障害給付の通知書、年金の明細書、裁判所の召喚状、陪審員の呼出状、自治体の許可証、入国関連書類 | | **その他の住所証明** | 賃貸借契約書、賃貸契約書、住所を確認する雇用主の書簡、保険証券、学校の入学通知書、住所の公証済み宣誓供述書、住所を確認する弁護士の書簡、学生ローンの明細書、住所を確認する裁判所の書類、住宅所有者保険の証券、賃借人保険の証券、自動車保険の証券、健康保険の明細書、医療費の請求書、病院の請求書、サブスクリプションサービスの請求書、ジム会員の明細書、不動産管理会社の書簡、管理組合の明細書、大学の成績証明書、大学の在籍証明書、給与明細、在職証明書、退職金口座の明細書、証券口座の明細書 |#### 対応国既定では、住所証明は、タークス・カイコス諸島（`TCA`）とツバル（`TUV`）を含め、本人確認と同じ国と地域に対応しています。対応するすべての国で、上記の4つの書類カテゴリを利用できます。この既定の対応範囲は、ワークフローの住所証明の設定で絞り込めます。> [!NOTE] > > 既存のワークフローに新しく対応した国が表示されない場合は、そのワークフローの住所証明の設定を開いて再度保存すると、ワークフローの許可国の設定が更新されます。![公共料金明細、銀行・公的機関の明細書など、Diditの住所証明で受け付ける書類の種類](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/proof-of-address-id-table.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=b065b2bb6f64408442b49d89ab16cb46)#### 一般的な要件- 発行日から90日以内の有効な書類 - 物理的に損傷のないもの（破れ、傷、汚れがない） - 住所情報の全体がはっきり見えること - 書類の発行元の名称とロゴが見えること - 書類上の氏名が、ユーザーの検証済みの本人情報と一致すること - 本人確認書類とは別のものであること（本人確認に使った同じ書類は使えません）#### 画像の要件- 原本を、リアルタイムで撮影したもの、または高品質のスキャン - 対応形式：JPG、JPEG、PNG、TIFF、PDF - 最大ファイルサイズ：15MB - 四隅がすべて写っているフルカラーの画像 - デジタル編集や加工がないこと - 複数ページの書類は、すべてのページを含めること This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.