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

# Ausweisverifizierung-API: 14,000+ Dokumente

> KI-gestützte Ausweisverifizierung mit Didit: 220+ Länder, 14,000+ Dokumente, 54 Sprachen. $0.15 pro Check, $10 gratis/Monat, sub-2s Inferenz.

Die Didit Ausweisverifizierung liest und authentifiziert behördlich ausgestellte Ausweisdokumente wie Reisepässe, Personalausweise, Führerscheine und Aufenthaltstitel in 220+ Ländern und für 14,000+ Dokumenttypen. Sie prüft das Dokument auf Manipulationen und Betrug und extrahiert anschließend dessen Daten mittels KI-basierter OCR. Sofern ein Land dies zulässt, können sich Personen auch ohne Dokument über einen Datenbankabgleich oder eine digitale ID-Wallet verifizieren ([drei Wege zur Verifizierung](#drei-wege-zur-verifizierung)).Die Academy-Lektion zum Lesen von Verifizierungsergebnissen behandelt die Ausweisverifizierung ab Minute 3:47 und zeigt, warum Echtheitsprüfungen vor den extrahierten Daten stehen.[Ausweisverifizierung: Echtheit vor Daten — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=227\&rel=0\&playsinline=1)

Integrations-Prompt für die Ausweisverifizierung
        Prompt in die Zwischenablage kopieren



      
      

\<pre>

\````# Goal
Integrate Didit ID Verification (OCR + document authenticity) into your app. Pick ONE of the two delivery modes below.

\# Mode A — Session-based (recommended for user-facing flows)
Use this when the user uploads / photographs their document in a hosted Didit flow. The feature is configured on a workflow and runs as part of /v3/session/.

1\. Create a workflow with the ID_VERIFICATION feature (Business Console or POST /v3/workflows/). Canonical feature enum: "OCR" (legacy) or "ID_VERIFICATION".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open the returned session.url for the user OR mount the Web/Mobile SDK.
4\. After completion fetch the decision — GET /v3/session/{sessionId}/decision/ (or subscribe to the session.status.updated webhook).

The decision response surfaces the result under the plural array `id_verifications[]` (one entry per document collected in the workflow).

\# Mode B — Standalone API (server-to-server)
Use when you already have one or two document images and want a one-shot OCR + checks call.

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

Required: front_image. Required for dual-sided docs (ID cards, driver licences): back_image.
Allowed extensions: tiff/jpg/jpeg/png/webp/pdf. Max 5 MB per file. Images must be uncropped — all 4 corners visible.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/id-verification/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'front_image=@./id_front.jpg' \
-F 'back_image=@./id_back.jpg' \
-F 'perform_document_liveness=true' \
-F 'minimum_age=18' \
-F 'expiration_date_not_detected_action=DECLINE' \
-F 'invalid_mrz_action=DECLINE' \
-F 'inconsistent_data_action=DECLINE' \
-F 'preferred_characters=latin' \
-F 'save_api_request=true' \
-F 'vendor_data=user-123'
\```
Returns: { request_id, id_verification: { status, full_name, document_type, document_number, date_of_birth, expiration_date, parsed_address, mrz, barcodes, portrait_image, front_document_image, back_document_image, warnings: [...] } }.

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

\# Warnings (LogWarningChoices.ID_VERIFICATION)
The warnings[] array on each id_verification carries risk codes including:
DOCUMENT_EXPIRED, INVALID_MRZ, INCONSISTENT_DATA, COULD_NOT_RECOGNIZE_DOCUMENT, DOCUMENT_LIVENESS_FAILED, MIN_AGE_NOT_REACHED, MAX_AGE_EXCEEDED, EXPIRATION_DATE_NOT_DETECTED, DUPLICATED_DOCUMENT, FRAUD_RISK_FROM_OCR, COUNTRY_NOT_ALLOWED, DOCUMENT_TYPE_NOT_ALLOWED.
Full catalogue: /core-technology/id-verification/warnings-id-verification.

\# Failure modes to handle
\- HTTP 403 "You don't have enough credits..." — insufficient balance.
\- HTTP 400 with multipart validation errors (missing back_image on dual-sided docs, file > 5 MB, unsupported extension).
\- status="Declined" with one or more terminal warnings (DOCUMENT_EXPIRED, DOCUMENT_LIVENESS_FAILED, COULD_NOT_RECOGNIZE_DOCUMENT, etc.) — surface the first warning's long_description to the user and stop the flow.
\- status="In Review" with a DOCUMENT_LIVENESS_NOT_COMPUTED warning — the requested forgery check produced no usable score (provider error or crash); treat the document as unchecked and route it to your manual-review queue.
\- status="In Review" — route to your manual-review queue; do not approve the user.

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

\</pre>



      
      

Einfügen in

![Didit Ausweisverifizierungsschritte von der Dokumentenerfassung bis zur KI-gestützten Analyse und Entscheidung](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-verification-steps.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=42c64546f3495000d7ea3b10c4b5fa50)**1. Intelligente Erfassung**Starten Sie den Verifizierungsprozess mühelos mit unserem intuitiven, KI-gestützten Erfassungssystem. Benutzer laden ihre Ausweisdokumente hoch oder fotografieren sie mit Unterstützung in Echtzeit:* **Automatische Erkennung** von Dokumenttyp und Ausstellungsland
* **Visuelle Echtzeit-Hinweise** für optimale Positionierung, Beleuchtung und Schärfe
* **Automatische Erfassung**, sobald die Bedingungen ideal sind – keine manuellen Wiederholungsversuche erforderlich
* Unterstützt **Reisepässe**, **Führerscheine**, **Personalausweise** und **Aufenthaltstitel**> [!NOTE]
>
> *Warum das wichtig ist*: Unsere intelligente Erfassung reduziert Reibungsverluste für Benutzer und stellt sicher, dass Dokumente gleich beim ersten Versuch in hoher Qualität übermittelt werden – das steigert Konversionsraten und Vertrauen.**2. Erweiterte Datenverarbeitung**Extrahieren und validieren Sie Identitätsdaten mit unübertroffener Präzision.**Datenextraktion** – Modernste Technologie verarbeitet alle zentralen Felder:| Funktion | Details |
| - | - |
| **Feldextraktion** | Vollständiger Name, Geburtsdatum, Dokumentnummer, Ausstellungs-/Ablaufdatum, Staatsangehörigkeit und mehr |
| **OCR** | Hochpräzise Texterkennung |
| **MRZ-Parsing** | Dekodierung der maschinenlesbaren Zone (Machine-Readable Zone) |
| **Barcode-Dekodierung** | Automatische Datenextraktion aus Barcodes |**Datenvalidierung**:* Gleicht Daten zwischen visuellen Zonen, MRZ und Barcodes auf Konsistenz ab
* Kryptografische Verifizierung von ausstellerseitig signierten Barcodes, sofern die Ausstellungsbehörde die zur Überprüfung erforderlichen Zertifikate veröffentlicht. Französische Personalausweise werden bereits unterstützt: Ihr ANTS-2D-Doc-Barcode wird anhand eines Signaturzertifikats überprüft, das mit der ANTS-Trust-List verknüpft ist. Dadurch werden Barcodes, die nicht von der Behörde signiert wurden, selbst dann erkannt, wenn ihr Inhalt konsistent erscheint
* Format- und Musterabgleich zur Erkennung von Anomalien
* Echtzeitabfragen behördlicher Datenbanken (sofern zulässig) für eine verbindliche Verifizierung> [!NOTE]
>
> *Warum das wichtig ist*: Eine umfassende Datenverarbeitung gewährleistet Genauigkeit, eliminiert Fehler und gibt Ihnen Sicherheit bei jeder Verifizierung.**3. Erweiterte Analyse**Unser KI-gestütztes System führt umfassende Prüfungen durch, um die Integrität und Echtheit von Dokumenten sicherzustellen:- Überprüfung der **Dokumentenechtheit**
- **Erkennung von Manipulationen** und Analyse der Bildintegrität
- **Liveness-Erkennung für Dokumente** zur Verhinderung von Betrug durch:
  * Bildschirmaufnahmen digitaler Dokumente
  * Fotos von Dokumenten, die auf Bildschirmen angezeigt werden
  * Gedruckte Dokumentenkopien
  * Manipulierte Dokumente mit veränderten Porträtfotos
- **Validierung von Sicherheitsmerkmalen** (Hologramme, Wasserzeichen usw.)
- **Vorlagenabgleich** mit einer zertifizierten Datenbank**4. Nahtlose Ergebnisse & Integration**Erhalten Sie sofort verwertbare Erkenntnisse mit flexiblen Bereitstellungsoptionen.**Echtzeitergebnisse**:- Unmittelbare Updates über ein intuitives Dashboard
- Sofortige Webhook-Benachrichtigungen für automatisierte Workflows
- REST-API für die nahtlose Integration in Ihre bestehenden Systeme**Umfassende Berichterstellung**:* Detaillierte PDF-Berichte mit Verifizierungsergebnissen und Nachweisen
* Audit-Trails für Compliance und zur Dokumentation
* Anpassbare Optionen zur Abstimmung auf Ihre betrieblichen Anforderungen> [!NOTE]
>
> *Warum das wichtig ist*: Schnelle, leicht zugängliche Ergebnisse ermöglichen es Ihrem Team, zügig zu handeln, während gleichzeitig ein sicherer, auditierbarer Prozess gewährleistet bleibt.***## Drei Wege zur VerifizierungEin fotografiertes Dokument ist eine von drei [Methoden der Ausweisverifizierung](https://docs.didit.me/de/core-technology/id-verification/verification-methods.md). Je nach Land können Sie Personen ermöglichen, ihre Identität gänzlich ohne Dokument nachzuweisen:- **[Dokumentenloser Abgleich](https://docs.didit.me/de/core-technology/id-verification/non-doc-lookup.md)** — Der Benutzer gibt seine nationale Identifikationsnummer sowie einige persönliche Daten ein, und wir prüfen diese gegen ein behördliches Register oder eine andere maßgebliche Quelle, die je nach Land angegeben wird. Sofern diese Quelle ein Porträtfoto zurückgibt, sind ein Selfie, passive Liveness und ein Gesichtsabgleich enthalten.
- **[Digitale ID-Wallets](https://docs.didit.me/de/core-technology/id-verification/digital-id-wallets.md)** — Der Benutzer meldet sich mit einer staatlichen oder bankgestützten digitalen Identität wie MitID, BankID oder itsme an, und die Wallet übermittelt einen signierten Satz von Attributen.Alles auf dieser Seite beschreibt die Dokumentenerfassung, die unverändert bleibt: Ein Workflow, der keine Angaben zu den Methoden macht, bleibt ausschließlich bei der Dokumentenerfassung.***## DokumentenanforderungenFür eine optimale Verifizierungsquote müssen Dokumente folgende Standards erfüllen:#### Allgemeine Anforderungen- Behördlich ausgestellt und innerhalb der konfigurierten Gültigkeitsdauer gültig
- Physisch unbeschädigt (keine Beschädigungen, Kratzer oder Flecken, die Details verdecken)
- Alle entscheidenden Informationen (vollständiger Name, Geburtsdatum, MRZ usw.) deutlich lesbar
- Konsistente Daten über alle eingereichten Dokumente hinweg#### Bildanforderungen- Originales Echtzeitfoto (keine Screenshots, Scans oder digitalen Kopien)
- Unterstützte Formate: JPG, JPEG, PNG, PDF
- Maximale Dateigröße: 5MB
- Farbbild, auf dem alle Dokumentenecken sichtbar sind
- Frei von Blendungen, Schatten, digitaler Nachbearbeitung oder Manipulation
- Physische Dokumente erforderlich (digitale Ausweise werden nur in ausgewählten Regionen unterstützt, in denen sie offiziell anerkannt sind)## Zusätzliche Einstellungen nach Land und DokumenttypKonfigurieren Sie detaillierte Regeln pro Land und Dokumenttyp direkt in der Konsole. Mit diesen Steuerelementen passen Sie Akzeptanzkriterien und Transkriptionspräferenzen an Ihre Compliance-Anforderungen an.![Didit-Bedienfeld für zusätzliche Ausweisverifizierungseinstellungen für länderspezifische Ablauf- und Akzeptanzregeln](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-additional-settings.jpeg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=4238b10a404795a61926fbdf1a3adc20)* **Ablaufmodus**: Wählen Sie, wie Dokumente mit abgelaufenem Gültigkeitsdatum behandelt werden sollen.

  * **Abgelaufene ablehnen**: Wenn das Ablaufdatum des Dokuments vor dem heutigen Tag liegt, wird es als abgelaufen markiert und abgelehnt.
  * **Abgelaufene zulassen**: Dokumente mit abgelaufenem Gültigkeitsdatum werden weder markiert noch blockiert.

  Diese Einstellung steuert auch die Überwachung nach der Genehmigung, die standardmäßig aktiviert ist: Bei **Abgelaufene ablehnen** wechselt eine genehmigte Sitzung zu `"Kyc Expired"`, sobald das Ablaufdatum des Dokuments später überschritten wird, und `status.updated` wird ausgelöst; bei **Abgelaufene zulassen** bleibt sie genehmigt und wird nie überwacht. Siehe [Dokumentüberwachung](https://docs.didit.me/de/core-technology/id-verification/document-monitoring-id-verification.md).
  In der Workflow-API akzeptiert die länderspezifische Dokumenteinstellung `expiration_check_mode` die Werte `strict` (**Abgelaufene ablehnen**), `allow_expired` (**Abgelaufene zulassen**) und `local_regulation`.
  `local_regulation` folgt den länderspezifischen Vorschriften, sofern Didit solche hinterlegt hat, und lehnt abgelaufene Dokumente in allen anderen Fällen ab.
  Jeder andere Wert wird abgelehnt.
* **Bevorzugtes Zeichenformat**: Wählen Sie aus, wie extrahierte Namen und Felder normalisiert werden sollen.
  * **Lateinische Schriftzeichen bevorzugen (A–Z)**: Beispiel: „Mohammed“
  * **Ursprüngliches Schriftsystem bevorzugen (nicht-lateinisch)**: Beispiel: „محمد“
* **Regionale Unterstützung und Untertypen**: Aktivieren Sie Dokumente nach Region und legen Sie zulässige Untertypen fest, wenn ein Dokumenttyp viele Varianten umfasst.
  * Beispiel: Wählen Sie für US-Führerscheine genau die Untertypen aus, die Sie akzeptieren (z. B. Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License usw.).
  * Nutzen Sie das Steuerelement „Akzeptierte Untertypen“, um schnell zahlreiche Varianten ein- oder auszuschließen (z. B. „128 ausgewählt“).> Tipp: Diese Einstellungen gelten pro Land und Dokumenttyp. So können Sie in bestimmten Märkten strenge Vorgaben machen und in anderen toleranter verfahren.## Länderspezifische AltersbeschränkungenSetzen Sie Mindest- und Höchstaltersanforderungen während der Ausweisverifizierung länderspezifisch durch. Das System extrahiert das Geburtsdatum des Benutzers aus dem eingereichten Dokument und gleicht es mit den für das Ausstellungsland konfigurierten Altersgrenzen ab.### KonfigurationAltersbeschränkungen werden als länderspezifische Tabelle direkt in der Konsole konfiguriert:| Spalte | Beschreibung |
| - | - |
| **Land** | Das Ausstellungsland des Dokuments (ISO 3166-1 Alpha-3). Es werden nur Länder angezeigt, die in Ihrer Positivliste für Dokumente aktiviert sind. |
| **Mindestalter** | Erforderliches Mindestalter. Benutzer, die jünger als dieser Wert sind, lösen die konfigurierte Aktion aus (Ablehnen oder Überprüfung). |
| **Höchstalter** | Zulässiges Höchstalter. Benutzer, die älter als dieser Wert sind, lösen die konfigurierte Aktion aus. Bei keiner Obergrenze leer lassen. |
| **Überschreibungen für Bundesstaaten/Regionen** | Öffnen Sie bei Ländern mit regional abweichenden Altersgrenzen (z. B. Vereinigte Staaten, Mexiko) das Einstellungssymbol, um Mindest- und Höchstalter pro Bundesstaat bzw. Region zu konfigurieren, die die Standardwerte auf Länderebene überschreiben. |### Standardwerte für die VolljährigkeitDie Konsole enthält die Schaltfläche **„Volljährigkeitsalter anwenden“**, die das Mindestalter jedes Landes automatisch mit dem gesetzlichen Volljährigkeitsalter ausfüllt (in den meisten Ländern 18 Jahre, mit Ausnahmen wie 19 in Südkorea, 21 in den VAE, 20 in Neuseeland usw.). Anschließend können Sie einzelne Länder anpassen oder bei Bedarf Überschreibungen auf Bundesstaatsebene hinzufügen.### Überschreibungen für Bundesstaaten und RegionenEinige Länder haben je nach Bundesstaat oder Region unterschiedliche gesetzliche Altersgrenzen. Beim Scannen eines Dokuments extrahiert das OCR-System die Region (z. B. „Mississippi“, „Alabama“, „Jalisco“) aus dem Dokument. Ist eine Überschreibung für diesen Bundesstaat bzw. diese Region konfiguriert, hat sie Vorrang vor der Alterseinstellung auf Länderebene.Wenn beispielsweise für die Vereinigten Staaten ein Mindestalter von 18 Jahren gilt, für Mississippi jedoch eine Überschreibung auf 21 Jahre konfiguriert ist, wird bei einem Benutzer, der einen Führerschein aus Mississippi vorlegt, das Mindestalter von 21 Jahren geprüft.### Konfigurierbare AktionenFällt das Alter eines Benutzers außerhalb des für das Land (oder den Bundesstaat) seines Dokuments festgelegten Bereichs, können Sie die Aktion auswählen:* **Ablehnen**: Die Sitzung wird automatisch abgelehnt.
* **Überprüfung**: Die Sitzung wird zur manuellen Prüfung markiert.> [!NOTE]
>
> Länderspezifische Altersbeschränkungen funktionieren auch mit Workflows zur **Adaptiven Altersverifizierung**. Wenn ein Grenzwertfall einen Fallback auf die Ausweisverifizierung auslöst, nutzt die Altersprüfung diese länderspezifischen Einstellungen, um die endgültige Entscheidung basierend auf dem Ausstellungsland und der Region des Dokuments zu treffen.


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