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

# Benutzerdokumente: Ausweise, Adressnachweis, Belege

> Ausweise, Adressnachweise und Belege zu Didit-Benutzern: was erfasst wird, wie Sie sie abrufen und wie Sie sie über die Konsole hochladen.



Prompt für Benutzerdokumente
        Prompt in die Zwischenablage kopieren



      
      

\<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>



      
      

Einfügen in

Jedes Dokument, das ein Benutzer während der Verifizierung hochlädt, ist dauerhaft mit seiner Benutzerentität verknüpft. Diese Seite erklärt, welche Daten erfasst werden, wie Sie sie abrufen und wie Sie zusätzliche Dokumente manuell hochladen.## Was Didit erfasst| Dokumenttyp | Zeitpunkt der Erfassung | Extrahierte Felder |
| - | - | - |
| **Amtlicher Ausweis** (Reisepass, nationaler Ausweis, Führerschein, Aufenthaltstitel) | Schritt [Ausweisverifizierung](https://docs.didit.me/de/core-technology/id-verification/overview.md) | Name, Geburtsdatum, Dokumentnummer, Ausstellungsland, Ablaufdatum, MRZ sofern vorhanden |
| **Selfie / Liveness-Erkennungs-Frames** | Schritt [Liveness](https://docs.didit.me/de/core-technology/liveness/overview.md) | Größter Gesichtsausschnitt, Wert der passiven Liveness-Erkennung |
| **Adressnachweis (POA)** | Schritt [POA](https://docs.didit.me/de/core-technology/proof-of-address/overview.md) | Name, Adresse, Aussteller, Dokumentdatum |
| **NFC-Chip-Auslese** | Schritt [NFC-Verifizierung](https://docs.didit.me/de/core-technology/nfc-verification/overview.md) | Chipdaten, ICAO-Zertifikatskette, Abgleich mit OCR |
| **Zusätzliche Dokumente** | Anfrage durch einen Analysten oder benutzerdefinierte Workflow-Schritte | OCR, sofern anwendbar, andernfalls unverändert gespeichert |[Unterstützte Dokumenttypen](https://docs.didit.me/de/core-technology/id-verification/supported-documents-id-verification.md) deckt die vollständige Matrix aus Land und Dokumenttyp ab (14,000+ Dokumente in 220+ Ländern).## Dokumente abrufenDokumente sind der **Sitzung** zugeordnet, in der sie erfasst wurden, nicht direkt dem Benutzer. Um alle Dokumente eines Benutzers aufzulisten:**1. Sitzungen des Benutzers auflisten**```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. Entscheidung jeder Sitzung abrufen**Jede Sitzungsentscheidung enthält URLs zu den erfassten Dokumenten.```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```Prüfen Sie in der Antwort die Felder `id_verification.document_images`, `proof_of_address.document_images` und `liveness.images`.**3. Signierte URLs verwenden**Bild-URLs in der Antwort sind kurzlebige signierte URLs. Speichern Sie sie clientseitig für die Dauer der Nutzung, oder rufen Sie die Entscheidung erneut ab, wenn sie ablaufen.## PDF-Bericht erstellenFür einen lesbaren Export aller für eine Sitzung erfassten Daten, einschließlich aller Dokumente, verwenden Sie:**`GET /v3/session/{session_id}/generate-pdf/`**Gibt ein PDF mit Sitzungsdetails, Funktionsergebnissen und eingebetteten Dokumentbildern zurück. Nützlich für Compliance-Audits, SAR-Anhänge und behördliche Einreichungen.## Dokumente aus der Konsole hochladenCompliance-Beauftragte können zusätzliche Dokumente zu einem Benutzer oder einer aktiven Sitzung hochladen:1. Navigieren Sie zu *Users → \[user] → Documents → Upload document*.
2. Wählen Sie einen Dokumenttyp (ID, POA, benutzerdefiniert).
3. Laden Sie eine Datei hoch. Für unterstützte Typen läuft OCR automatisch.
4. Das Dokument wird der neuesten Sitzung zugeordnet (oder Sie erstellen eine Korrektursitzung).> [!NOTE]
>
> Die Upload-Oberfläche für Dokumente ist nur in der Konsole verfügbar. Es gibt keinen öffentlichen API-Endpoint, um Dokumente direkt einem Benutzer zuzuordnen. Verwenden Sie Sitzungen als Einstiegspunkt für jede Dokumenterfassung.## Querprüfung von DokumentenErfasst eine Sitzung mehrere Dokumenttypen, gleicht Didit sie miteinander ab:- **ID ↔ Liveness**: Das Gesicht im Ausweis stimmt mit dem Selfie aus der Liveness-Erkennung überein.
- **ID ↔ POA**: Der Name im Adressnachweis stimmt mit dem Namen überein, der aus dem Ausweis extrahiert wurde.
- **ID ↔ NFC**: MRZ- bzw. visuelle Daten stimmen mit den NFC-Chipdaten überein.Inkonsistenzen werden als Warnungen in der Sitzungsentscheidung angezeigt und können so konfiguriert werden, dass sie eine manuelle Prüfung auslösen.## Dokumentenüberwachung und erneute VerifizierungFür Anwendungsfälle, die eine laufende Gültigkeitsprüfung von Dokumenten erfordern (z. B. abgelaufene Ausweise):- **Das Ablaufdatum des Dokuments** wird bei jedem verifizierten Ausweis nachverfolgt. Fragen Sie in der Sitzungsentscheidung das Feld `expiration_date` ab.
- **Dokumentüberwachung** ist standardmäßig aktiviert und läuft automatisch: Es muss nichts aktiviert werden. Wenn das Ablaufdatum des Ausweises verstreicht, wechselt eine Sitzung mit dem Status `"Approved"` zu `"Kyc Expired"`, das Ergebnis der Ausweisverifizierung erhält eine `DOCUMENT_EXPIRED`-Warnung, und ein `status.updated`-Webhook wird ausgelöst. Vor dem Ablaufdatum wird keine Warnung gesendet.
- **Deaktivieren**: Setzen Sie in den [Einstellungen der ID-Verifizierung](https://docs.didit.me/de/core-technology/id-verification/overview.md) für das betreffende Land und den Dokumenttyp **Expiration mode** auf **Allow expired**. **Reject expired** ist der Standardmodus und der Modus, in dem überwacht wird. Ein Dokument, das im Modus **Allow expired** akzeptiert wurde, wird nie überwacht.
- **Erneute Verifizierung**: Starten Sie eine neue Sitzung mit demselben `vendor_data`, um die Dokumente zu aktualisieren.## Geolokalisierung von DokumentenDie [Geolokalisierungsprüfung des ID-Dokuments](https://docs.didit.me/de/core-technology/id-verification/document-geolocation-id-verification.md) vergleicht den IP-Standort des Einreichenden mit dem Ausstellungsland des Ausweises. Die Ergebnisse werden der Sitzungsentscheidung beigefügt.## Datenschutz und Aufbewahrung- Alle Dokumente sind im Ruhezustand verschlüsselt.
- Der Zugriff auf Bilder erfolgt über kurzlebige signierte URLs.
- Die Aufbewahrung richtet sich nach der Richtlinie zur [Datenaufbewahrung](https://docs.didit.me/de/console/data-retention.md) der Anwendung.
- Benutzer haben das Recht, eine Löschung zu verlangen. Bei einer Löschung werden Bilder, OCR-Extrakte und NFC-Daten entfernt.## Nächste Schritte> [card] [Ausweisverifizierung](https://docs.didit.me/de/core-technology/id-verification/overview.md)
>
> Wie die Ausweiserfassung und OCR funktionieren.> [card] [Adressnachweis](https://docs.didit.me/de/core-technology/proof-of-address/overview.md)
>
> Erfassung von POA-Dokumenten.> [card] [Entscheidung der Sitzung](https://docs.didit.me/de/sessions-api/retrieve-session.md)
>
> Referenz zu GET /v3/session/{id}/decision/.


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