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

# Adressnachweis-API: Verifizierung per Versorgungsrechnung

> Wohnadressen mit Didit verifizieren: KI-Extraktion aus Verbrauchsabrechnungen, Kontoauszügen & Dokumenten. Pay-per-Call für $0.20.

Die Adressnachweis-Verifizierung (PoA) ermöglicht es Ihnen, die Wohnadresse eines Benutzers anhand amtlicher Dokumente zu verifizieren. Diese Funktion vereinfacht den Prozess der Adressverifizierung, sodass Benutzer Dokumente, die ihre Adresse bestätigen, aufnehmen oder hochladen können.

Adressnachweis-Integrations-Prompt
        Prompt in die Zwischenablage kopieren



      
      

\<pre>

\````# 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 503 with `code: "document_processing_busy"`: too many documents are being processed, so the upload was not processed. Send the same file again after the `Retry-After` seconds.
\- 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````

\</pre>



      
      

Einfügen in

Die Academy-Lektion zum Lesen eines Verifizierungsergebnisses behandelt bei 7:20 die Adressnachweisprüfung.[Adressnachweis — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Wie es funktioniertDie Adressnachweisverifizierung von Didit bietet eine robuste Lösung zur Verifizierung der Wohnanschrift eines Benutzers anhand offizieller Dokumente. Unsere Lösung kombiniert fortschrittliche KI, Computer Vision und umfassende Sicherheitsprüfungen, um eine schnelle, zuverlässige Adressverifizierung im großen Maßstab bereitzustellen.**1. Intelligente Dokumentenerfassung**Benutzer können ihre Adresse über folgende Wege verifizieren:| Methode | Beschreibung |
| - | - |
| **Automatische Erfassung** | Unsere KI erkennt automatisch die optimale Dokumentpositionierung und nimmt das Dokument im perfekten Moment automatisch auf |
| **Upload-Option** | Benutzer können vorhandene Dokumente in verschiedenen Formaten hochladen (PDF, JPG, PNG) |
| **Unterstützung mehrseitiger Dokumente** | Verarbeitet mehrseitige Dokumente wie Kontoauszüge nahtlos |**2. Erweiterte Datenextraktion und -verifizierung**Leistungsstarke Verarbeitungsfunktionen:- Hochpräzise OCR zur Extraktion von Adressinformationen
- Intelligente Dokumentenklassifizierung zur Erkennung von Dokumenttypen
- Namensabgleich mit Ausweisdokumenten zur Gegenprüfung
- Extraktion des Ausstellungsdatums und Validierung anhand konfigurierter Anforderungen
- Format- und Musterabgleich für alle Adressfelder**3. Umfassende Validierung**Unser KI-gestütztes System führt umfassende Prüfungen durch:| Prüfung | Beschreibung |
| - | - |
| **Dokumentenechtheit** | Verifizierung der Legitimität des Dokuments |
| **Manipulationserkennung** | Analyse der Bildintegrität zur Erkennung von Manipulationen |
| **Adressstandardisierung** | Formatierung und Normalisierung von Adressfeldern |
| **Geocodierung** | Bereitstellung von Standortkoordinaten aus der extrahierten Adresse |
| **Spracherkennung** | Erkennung und Validierung der Dokumentsprache |**4. Nahtlose Ergebnisbereitstellung**Greifen Sie über mehrere Kanäle auf Verifizierungsergebnisse zu:- Dashboard-Aktualisierungen in Echtzeit
- Sofortige Webhook-Benachrichtigungen
- RESTful-API-Integration
- Umfassende Berichte mit detaillierten Informationen zur Verifizierungssitzung## DokumentanforderungenDamit die Adressverifizierung erfolgreich verläuft, sollten Dokumente die folgenden Kriterien erfüllen:#### Akzeptierte DokumenttypenDie folgende Tabelle führt die akzeptierten Dokumenttypen und ihre jeweiligen Untertypen auf. Sofern nicht anders angegeben, müssen alle Dokumente innerhalb der letzten 3 Monate ausgestellt worden sein.| Dokumenttyp | Untertypen |
| - | - |
| **Versorgungsrechnung** | Stromrechnung, Wasserrechnung, Gasrechnung, Internetrechnung, Telefonrechnung, Kabel-TV-Rechnung, Satelliten-TV-Rechnung, Müllabfuhrrechnung, Abwasserrechnung, Heizkostenabrechnung, kombinierte Versorgungsrechnung, kommunale Dienstleistungsabrechnung |
| **Kontoauszug** | Kontoauszug, Kreditkartenabrechnung, Bankbestätigung der Adresse, Hypothekenabrechnung, Darlehensabrechnung, Sparkontoauszug, Girokontoauszug, Anlagekontoauszug, Geschäftskontoauszug, Credit-Union-Abrechnung, Debitkartenabrechnung, Kreditrahmenabrechnung |
| **Behördlich ausgestelltes Dokument** | Steuerbescheid, Wählerregistrierungskarte, Ausweisdokument, Meldebescheinigung, behördliches Schreiben/Benachrichtigung, Zensus-Schreiben, individuelle Registrierungsbescheinigung, Grundsteuerbescheid, Fahrzeugzulassungsbescheinigung, Sozialversicherungsnachweis, Arbeitslosengeldbescheid, Erwerbsminderungs-/Behindertenleistungsbescheid, Rentenbescheid, gerichtliche Vorladung, Benachrichtigung zum Geschworenendienst, kommunale Genehmigung, Einwanderungsdokument |
| **Sonstiger Adressnachweis** | Mietvertrag, Mietvereinbarung, Arbeitgeberbestätigung der Adresse, Versicherungspolice, Schulbescheinigung, notariell beglaubigte eidesstattliche Adresserklärung, anwaltliches Schreiben zur Adressbestätigung, Studienkreditabrechnung, gerichtliches Dokument zur Adressbestätigung, Wohngebäudeversicherungspolice, Mieterversicherungspolice, Kfz-Versicherungspolice, Krankenversicherungsnachweis, Arztrechnung, Krankenhausrechnung, Abonnementrechnung, Fitnessstudio-Mitgliedschaftsbescheinigung, Schreiben der Hausverwaltung, Abrechnung der Eigentümergemeinschaft, Universitäts-Notenspiegel, Immatrikulationsbescheinigung, Gehaltsabrechnung, Beschäftigungsnachweis, Altersvorsorgekonto-Abrechnung, Depotabrechnung |#### LänderverfügbarkeitStandardmäßig unterstützt Adressnachweis dieselben Länder und Gebiete wie die Ausweisverifizierung, einschließlich Turks- und Caicosinseln (`TCA`) und Tuvalu (`TUV`). Jedes unterstützte Land bietet die vier oben aufgeführten Dokumentkategorien. Sie können diese Standardabdeckung in den Adressnachweis-Einstellungen Ihres Workflows einschränken.> [!NOTE]
>
> Falls ein bestehender Workflow ein neu unterstütztes Land nicht anzeigt, öffnen Sie seine Adressnachweis-Einstellungen und speichern Sie diese erneut, um die Konfiguration der zulässigen Länder des Workflows zu aktualisieren.![Didit Adressnachweis akzeptierte Dokumenttypen – Versorgungsrechnungen, Bank- und Behördendokumente](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)#### Allgemeine Anforderungen- Gültiges Dokument, dessen Ausstellungsdatum nicht länger als 90 Tage zurückliegt
- Physisch unbeschädigt (frei von Schäden, Kratzern oder Flecken)
- Vollständige Adressdaten gut lesbar
- Name und Logo des Ausstellers sichtbar
- Der Name auf dem Dokument sollte mit der verifizierten Identität des Benutzers übereinstimmen
- Muss sich vom Ausweisdokument unterscheiden (darf nicht dasselbe Dokument sein, das für die Ausweisverifizierung verwendet wurde)#### Bildanforderungen- Originaldokument in Echtzeit erfasst oder als hochwertiger Scan
- Unterstützte Formate: JPG, JPEG, PNG, TIFF, PDF
- Maximale Dateigröße: 15MB
- Farbbild mit allen Ecken sichtbar
- Keine digitale Bearbeitung oder Manipulation
- Bei mehrseitigen Dokumenten sind alle Seiten enthalten


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