Ausweisverifizierungsbericht: Felder & Qualitätswerte

Übersicht

Der Bericht zur Ausweisverifizierung erfasst alles, was Didit aus einem behördlichen Ausweisdokument extrahiert und validiert hat – Reisepässe, Personalausweise, Führerscheine und Aufenthaltstitel. Er bündelt die per OCR erfassten biografischen Daten und Dokumentenfelder, signierte URLs zu den aufgenommenen Medien, analysierte und geolokalisierte Adressdaten, Bildqualitätswerte pro Seite, MRZ-Inhalte, Aufschlüsselungen nach mehreren Schriftsystemen (lateinisch / nicht-lateinisch) sowie sitzungsübergreifende Dokumentenabgleiche. Der Bericht wird erstellt, nachdem der Benutzer den Schritt zur Dokumentenerfassung in einem Workflow abgeschlossen hat (oder den Standalone-OCR-Endpoint aufruft). Didit identifiziert den Dokumenttyp, führt OCR durch, validiert die MRZ / den Barcode / den QR-Code, parst die Adresse, prüft auf Manipulationen (Bildschirmaufnahme, gedruckte Kopie, Porträtmanipulation) und gleicht das Dokument mit jedem anderen in Ihrer Anwendung erfassten Dokument ab. Jeder Bericht enthält einen eigenen status – unabhängig vom allgemeinen Sitzungsstatus –, der widerspiegelt, wie der Ausweisschritt allein abgeschlossen wurde:

Genehmigt – Dokument erkannt, alle erforderlichen Felder extrahiert, keine Warnung ausgelöst, die zur Ablehnung führt.
In Überprüfung – eine oder mehrere Warnungen wurden ausgelöst und Ihr Workflow leitet diese zur Prüfung weiter.
Abgelehnt – eine Bedingung zur automatischen Ablehnung wurde ausgelöst (nicht unterstütztes Dokument, abgelaufenes Dokument, fehlendes Porträt, Treffer auf der Sperrliste, Fehlschlag bei adaptiver Altersschätzung) oder es wurde eine Warnung ausgelöst, deren konfigurierte Aktion Ablehnen ist (für Mindest-/Höchstalter ist standardmäßig die Aktion „Ablehnen“ konfiguriert).
Abgelaufen – das expiration_date des Dokuments ist nach der Verifizierung verstrichen. Die laufende Überwachung des Ablaufdatums von Didit ändert den Bericht von Approved zu Expired, fügt eine DOCUMENT_EXPIRED-Warnung hinzu und versetzt eine genehmigte Sitzung in den Sitzungsstatus Kyc Expired.
Nicht abgeschlossen – der Benutzer hat den Erfassungsschritt nie abgeschlossen.

Wo er in API-Antworten erscheint

Der Ausweisbericht wird innerhalb des id_verifications[]-Arrays bereitgestellt – immer als JSON-Array, niemals als einzelnes id_verification-Objekt. Mehrere Einträge erscheinen, wenn ein Workflow mehr als einen Dokumentenschritt ausführt (beispielsweise einen primären Ausweis plus eine Folgeverifizierung).

Sitzungsentscheidungs-API – GET /v3/session/{sessionId}/decision/ gibt id_verifications[] auf oberster Ebene zurück. Siehe Sitzungsentscheidung abrufen.
Webhooks – Payloads von session.status.updated enthalten dasselbe id_verifications[]-Array, sobald der Schritt Daten geliefert hat. Siehe Webhooks.
Standalone-OCR-API – die direkte Dokumentenübermittlung gibt ein einzelnes id_verification-Objekt mit denselben Feldern zurück. Siehe Standalone-OCR-API.

Lesen Sie response.id_verifications[0] und iterieren Sie über das Array. Die Form als einzelnes id_verification-Objekt existiert nur in der Standalone-OCR-API – sie existiert nicht am v3-Entscheidungs-Endpoint.

Schema

Das kanonische Schema Feld für Feld befindet sich auf der Referenzseite Datenmodelle. Die folgenden Felder stammen direkt aus IDVerificationV3Serializer, der IDVerificationV2Serializer erweitert und node_id, das sitzungsübergreifende Array matches[] sowie das Silent-Capture-Array document_selfie_face_matches[] hinzufügt.

Felder der obersten Ebene

Feld	Typ	Beschreibung
`status`	`"Approved" \| "Declined" \| "In Review" \| "Expired" \| "Not Finished"`	Status des Ausweisschritts.
`node_id`	string \| null	Workflow-Graph-Knoten, der diesen Bericht generiert hat.
`document_type`	`"Passport" \| "Identity Card" \| "Driver's License" \| "Residence Permit" \| "Health Insurance Card" \| "Tax Card" \| "Social Security Card" \| "Work Permit" \| "Visa" \| "Public Service Card" \| "Birth Certificate" \| "Firearm License" \| "Other" \| null`	Erkannte Dokumentenfamilie der obersten Ebene (menschenlesbar).
`document_subtype`	string \| null	Dokumenten-Subtyp-Code aus dem Dokumentenregister von Didit, gefiltert nach den von den Dokumenteneinstellungen des Workflows akzeptierten Werten. Regionsspezifische Dokumente enthalten die Region, zum Beispiel `QUEENSLAND_DRIVER_LICENSE_GENERIC`. Siehe Dokumenten-Subtypen für die vollständige Codeliste, einschließlich Hinweisen zur Unterscheidung eines US-amerikanischen gewerblichen Führerscheins (CDL) von einem Standardführerschein.
`document_number`	string	Per OCR erfasste Dokumentennummer. Bei Führerscheinen, die sowohl eine Führerscheinnummer als auch eine Kartennummer aufweisen, beachten Sie den Hinweis unter der Tabelle.
`personal_number`	string	Per OCR erfasste persönliche Identifikationsnummer / nationale Identifikationsnummer, sofern sie sich von der Dokumentennummer unterscheidet.
`portrait_image`, `front_image`, `front_video`, `back_image`, `back_video`, `full_front_image`, `full_back_image`	string (signierte URL)	Erfasste Medien. URLs sind signiert und zeitlich begrenzt – laden Sie sie zeitnah herunter, speichern Sie die URL niemals dauerhaft.
`front_image_camera_front`, `back_image_camera_front`	string (signierte URL) \| null	Während der Dokumentenerfassung von der nach vorne gerichteten Kamera des Benutzers aufgenommene Frames. Wird für den kameraübergreifenden Gesichtsabgleich verwendet und mit Ihrer Gesichts-Sperrliste abgeglichen; jedes Bild kann auch zur Gesichts-Sperrliste hinzugefügt werden.
`front_image_camera_front_face_match_score`, `back_image_camera_front_face_match_score`	float (0–100) \| null	Ähnlichkeitswert zwischen dem Frame der Frontkamera und dem Porträt auf dem Dokument.
`document_selfie_face_matches`	array \| null	Vorherige Sitzungen oder Einträge der Gesichts-Sperrliste, deren Gesicht mit dem während der Dokumentenerfassung aufgenommenen Selfie übereinstimmte (Silent Capture Gesichtssuche). Gleiches Eintragsformat wie `liveness_checks[].matches`; `match_image_url` ist eine vorab signierte URL, die abläuft. `null` bei älteren Sitzungen oder wenn die Suche nicht ausgeführt wurde, `[]`, wenn sie ausgeführt wurde und keine Treffer gefunden wurden.
`front_image_quality_score`, `back_image_quality_score`	object \| null	Qualitätsbewertung pro Seite (siehe Bildqualitäts-Scores).
`document_liveness`	object \| null	Dokument-Liveness-Scores pro Betrugsart zusammen mit den Schwellenwerten, anhand derer sie bewertet wurden (siehe Dokument-Liveness-Scores). Nur V3.
`date_of_birth`, `expiration_date`, `date_of_issue`	string (YYYY-MM-DD)	Dokumentdaten.
`age`	number	Aus `date_of_birth` berechnetes Alter des Inhabers in Jahren.
`issuing_state`	string (ISO 3166-1 alpha-3)	Ländercode des Ausstellungslandes.
`issuing_state_name`	string	Lokalisierter Ländername.
`first_name`, `last_name`, `full_name`	string	Name des Inhabers im durch `preferred_characters` ausgewählten Schriftsystem (siehe unten).
`gender`	`"M" \| "F" \| "U"`	Geschlecht, sofern auf dem Dokument vorhanden (`U` = unbekannt).
`address`, `formatted_address`	string	Unformatierte und geokodierte/formatierte Adresszeichenfolgen.
`place_of_birth`	string	Per OCR erfasster Geburtsort.
`marital_status`	`"SINGLE" \| "MARRIED" \| "DIVORCED" \| "WIDOWED" \| "UNKNOWN"`	Familienstand, sofern auf dem Dokument vorhanden.
`nationality`	string (ISO 3166-1 alpha-3)	Staatsangehörigkeit des Inhabers, sofern abweichend vom Ausstellungsstaat.
`extra_fields`	object	Dokumentenspezifische Zusatzfelder (Führerscheinklassen, Blutgruppe, Namen in alternativen Schriftsystemen, `tax_number`, …).
`mrz`	object \| null	Geparste MRZ-Schlüssel/Wert-Felder.
`parsed_address`	object \| null	Strukturierte, geokodierte Adresse (`street_1`, `street_2`, `city`, `region`, `country`, `postal_code`, `address_type`, `formatted_address`, `document_location`, `raw_results`, `is_best_match`).
`extra_files[]`	Array signierter URLs	Zusätzliche, diesem Dokument beigefügte Bilder.
`matches[]`	array	Sitzungsübergreifende Dokumentenübereinstimmungen (siehe Sitzungsübergreifende Übereinstimmungen).
`warnings[]`	array	Warnungen auf Modulebene – siehe Warnungen zur Ausweisverifizierung.

issuing_state ist immer auf Länderebene, niemals auf subnationaler Ebene. Bei jedem Dokumententyp, einschließlich Führerscheinen, die von einem Bundesstaat oder einer Provinz ausgestellt wurden (Australien, die Vereinigten Staaten, Kanada), geben issuing_state und issuing_state_name das Land an (zum Beispiel AUS / Australia), nicht den Bundesstaat. Der subnationale Wert ist, sofern das Dokument einen solchen enthält, separat in parsed_address.region verfügbar (bei einigen Dokumententypen als Fallback in extra_fields.state). Die Sitzungsübersicht der Business Console zeigt dies, falls vorhanden, als Zeile Region unterhalb von Ausstellungsstaat an.

Führerscheine mit zwei Nummern (Australien). Australische Führerscheine enthalten sowohl eine Führerscheinnummer, die die Fahrberechtigung des Inhabers identifiziert und beim Austausch einer Karte unverändert bleibt, als auch eine Kartennummer, die die physische Karte identifiziert und sich bei jeder Neuausstellung ändert. Für diese Führerscheine ordnet Didit die Nummern stets gleich zu:

personal_number — die Führerscheinnummer
document_number — die Kartennummer

Dies gilt für jeden australischen Bundesstaat und jedes Territorium (NSW, VIC, QLD, WA, SA, TAS, ACT, NT). Bei einigen Varianten ist die Kartennummer nur auf der Rückseite aufgedruckt, sodass sie nur erfasst wird, wenn die Rückseite des Führerscheins aufgenommen wird. Wenn keine Kartennummer ausgelesen werden kann, wird die Führerscheinnummer sowohl als document_number als auch als personal_number ausgegeben, sodass document_number nach Abschluss der Verifizierung immer eine Kennung enthält. personal_number ist in jedem Fall die Führerscheinnummer. Bei anderen Dokumententypen bleibt document_number die primäre per OCR erfasste Nummer und kann selbst eine Kennung auf Inhaberebene sein.

Die argentinische CUIL ist extra_fields.tax_number, niemals personal_number. Argentinische Dokumente drucken die CUIL – die 11-stellige Kennung, auf die sich AFIP, ANSES und die Auskunfteien beziehen – auf jedem Dokument an einer anderen Stelle ab, und der DNI druckt eine zweite 11-stellige Nummer daneben:

Auf dem Führerschein enthält personal_number die CUIL;
auf dem DNI enthält personal_number die número de trámite, welche den Kartenantrag identifiziert und keine Kennung des Inhabers ist. Die CUIL des DNI wird aus dem dafür vorgesehenen gedruckten Feld ausgelesen.

Daher ist personal_number für Argentinien keine verlässliche CUIL: Auf einem DNI handelt es sich um eine 11-stellige Nummer, die bei Abfragen in Registern stillschweigend kein Ergebnis liefert. Lesen Sie stattdessen extra_fields.tax_number aus. Didit gibt dieses Feld nur zurück, wenn der Wert als echte CUIL validiert wird (Personenpräfix plus Modulo-11-Prüfziffer), als kanonische Ziffernfolge ohne Trennzeichen (27111111117), unabhängig davon, welches argentinische Dokument der Inhaber vorgelegt hat. Wenn die CUIL der Karte nicht gelesen werden konnte, fehlt der Schlüssel, anstatt mit einer Nummer befüllt zu werden, die keine CUIL ist – erfassen Sie den Führerschein als zweites Dokument oder erfassen Sie die CUIL über eine Antwort auf einen Fragebogen oder die metadata der Sitzung, um diese Benutzer abzudecken.

Bildqualitäts-Scores

front_image_quality_score und back_image_quality_score geben jeweils Folgendes zurück:

Feld	Typ	Was gemessen wird
`focus_score`	number 0–100	Schärfe – obere 10 % der lokalen Laplace-Varianz, robust gegenüber einheitlichen Hintergründen. Gewichtung 45 %.
`brightness_score`	number 0–100	Bestraft zu dunkle oder überbelichtete Bilder. Gewichtung 30 %.
`brightness_issue`	`"ok" \| "too_dark" \| "too_bright"`	Art des Helligkeitsproblems, wenn `brightness_score` niedrig ist.
`resolution_score`	number 0–100	Basiert auf der Gesamtzahl der Pixel der Aufnahme. Gewichtung 25 %.
`is_document_fully_visible`	boolean \| null	`true`, wenn alle vier Dokumentecken sichtbar sind, `false`, wenn eine Ecke abgeschnitten ist, `null`, wenn die Eckenerkennung nicht verfügbar war.
`overall_score`	number 0–100	Gewichteter Gesamtwert (Schärfe 45 %, Helligkeit 30 %, Auflösung 25 %).

Nutzen Sie overall_score als schnelle Eignungsprüfung – Werte über 70 deuten im Allgemeinen auf eine Aufnahme hin, die gut genug für eine zuverlässige Verifizierung ist.

Dokument-Liveness-Scores

document_liveness gibt an, was die Dokument-Liveness-Prüfung gemessen hat, unabhängig davon, ob eine Warnung ausgelöst wurde oder nicht. Eine Warnung existiert nur dann, wenn ein Wert einen der Schwellenwerte des Workflows unterschritten hat. Vor Einführung dieses Feldes enthielt ein genehmigtes Dokument daher keinerlei Nachweise zur Liveness-Erkennung – über dieses Feld können Sie eine erfolgreich durchlaufene Sitzung prüfen. Es ist null, wenn die Prüfung nicht ausgeführt wurde (beispielsweise bei einer Methode ohne Dokument oder bei einem in den Sitzungs-Logs erfassten Modellausfall). Es enthält ein Objekt pro Betrugsart – portrait_replace, printed_copy und screen_replay – jeweils mit:

Feld	Typ	Bedeutung
`score`	number 0–100 \| null	Wahrscheinlichkeit, dass das Dokument bezüglich dieser Betrugsart echt ist (höher = mit höherer Wahrscheinlichkeit echt). Es ist der niedrigere Wert der beiden Seiten, welcher für die Entscheidung herangezogen wurde. `null`, wenn keine der Seiten einen verwertbaren Wert erbracht hat – beispielsweise entfällt der Porträt-Score auf einer Seite, auf der kein Porträt gefunden wurde.
`front`, `back`	number 0–100 \| null	Derselbe Wert pro erfasster Seite. `null` für eine Seite, die nicht erfasst wurde oder deren Wert verworfen wurde.
`decline_threshold`, `review_threshold`	number \| null	Schwellenwerte, die gespeichert wurden, als der Ausweisverifizierungs-Knoten dieses Dokument ausgewertet hat. Spätere Änderungen am Workflow ändern diese nicht. `null`, wenn historische Bewertungsdaten nicht verfügbar sind.
`bucket`	`"approve" \| "review" \| "decline" \| null`	Einstufung von `score` im Vergleich zu diesen Schwellenwerten: unterhalb von `decline_threshold` → `decline`, unterhalb von `review_threshold` → `review`, andernfalls `approve`. `null`, wenn kein verwertbarer Wert vorliegt, die Prüfung nicht angewendet wurde oder historische Bewertungsdaten nicht verfügbar sind. Das Bucket beschreibt die Prüfung auf diese Betrugsart, nicht den Gesamtstatus der Sitzung.

"document_liveness": {
  "portrait_replace": {
    "score": 96.46,
    "front": 96.46,
    "back": 98.2,
    "decline_threshold": 35,
    "review_threshold": 70,
    "bucket": "approve"
  },
  "printed_copy": {
    "score": 91.2,
    "front": 91.2,
    "back": 93.7,
    "decline_threshold": 35,
    "review_threshold": 77,
    "bucket": "approve"
  },
  "screen_replay": {
    "score": 99.9,
    "front": 99.9,
    "back": 99.5,
    "decline_threshold": 30,
    "review_threshold": 70,
    "bucket": "approve"
  }
}

Bei älteren Dokumenten ohne gespeicherte Bewertungsnachweise bleiben gespeicherte Werte sichtbar, aber sowohl Schwellenwerte als auch bucket sind null. Aktuelle Workflow-Einstellungen werden niemals zur Rekonstruktion eines historischen Ergebnisses herangezogen. Dasselbe gilt für eine Erfassung, deren Dokumentauswertung noch nicht abgeschlossen ist. Die Business Console zeigt dieselben drei Zeilen im Block Dokument-Liveness-Erkennung des Bereichs Ausweisverifizierung der Sitzung an.

Sitzungsübergreifende Übereinstimmungen

matches[] listet bis zu 5 andere Dokumente in Ihrer Anwendung auf, die mit diesem übereinstimmen – gleiches Geburtsdatum, gleiches Ausstellungsland und ein stark ähnlicher vollständiger Name. Dokumente auf der Sperrliste erfordern zusätzlich eine exakte Übereinstimmung der Dokumentnummer. Sitzungen desselben Benutzers (gleiche vendor_data) werden ausgeschlossen. Jeder Eintrag enthält session_id, session_number, vendor_data, verification_date, user_details (name, document_type, document_number), status, is_blocklisted (true, wenn das Dokument zu Ihrer Sperrliste hinzugefügt wurde), api_service und eine signierte front_image_url.

Statuswerte

Status	Bedeutung	Nachgelagerte Auswirkung
`Approved`	Dokument erkannt, erforderliche Felder extrahiert, alle Prüfungen bei den konfigurierten Schwellenwerten bestanden.	Zählt als erfolgreiche Ausweisprüfung.
`In Review`	Eine oder mehrere Warnungen wurden ausgelöst und der Workflow leitet sie zur Prüfung weiter.	Die Sitzung wechselt ebenfalls zu `In Review`, bis ein Prüfer reagiert.
`Declined`	Bedingung für automatische Ablehnung ausgelöst (nicht unterstütztes Dokument, abgelaufenes Dokument, Porträt fehlt, Treffer auf der Sperrliste, Fehlschlag bei adaptiver Altersprüfung) oder eine auf Ablehnen konfigurierte Warnung wurde ausgelöst.	Die Sitzung wird abgelehnt, es sei denn, eine andere genehmigte Verzweigung erfüllt den Workflow.
`Expired`	Das Ablaufdatum des Dokuments wurde nach der Genehmigung überschritten. Wird durch die laufende Dokumentenüberwachung von Didit festgelegt, die standardmäßig aktiviert ist (ein Land und ein Dokumenttyp, für die Expiration mode auf Allow expired steht, sind ausgenommen), zusammen mit einer `DOCUMENT_EXPIRED`-Warnung.	Eine genehmigte Sitzung wechselt zu `Kyc Expired`.
`Not Finished`	Der Benutzer hat den Erfassungsschritt abgebrochen.	Die Ausweis-Verzweigung hat kein Ergebnis geliefert.

Dokumente mit mehreren Schriftsystemen (lateinisch / nicht-lateinisch)

Einige Dokumente — kirgisische, kasachische, russische, japanische, koreanische, chinesische, arabische, thailändische und andere — drucken den Namen, die Adresse oder den Geburtsort des Inhabers sowohl in einer lateinischen Transliteration als auch im lokalen Schriftsystem ab. Sie wählen über die Workflow- (oder Standalone-API-)Einstellung preferred_characters, welches Schriftsystem die Felder der obersten Ebene befüllt:

Wert	Befüllt Felder der obersten Ebene mit	Die Werte des jeweils anderen Schriftsystems werden in
`latin` (Standard)	Der auf dem Dokument aufgedruckten lateinischen Transliteration	`extra_fields.*_non_latin`
`non_latin`	Den auf dem Dokument aufgedruckten Werten im lokalen Schriftsystem	`extra_fields.*_latin`

Die Werte des alternativen Schriftsystems befinden sich in extra_fields unter Schlüsseln mit Suffix: first_name_non_latin, last_name_non_latin, middle_name_non_latin, full_name_non_latin, address_non_latin, place_of_birth_non_latin (oder den entsprechenden _latin-Varianten).

Wann Felder des alternativen Schriftsystems erscheinen

Nur wenn tatsächlich beide Schriftsysteme auf dem Dokument vorhanden sind. Wenn ein OCR-Feld, das nominell mit „Surname-Kyrgyz (Cyrillic)“ gekennzeichnet ist, als Text in lateinischer Schrift extrahiert wird (Homoglyphen oder eine lateinische Transliteration), gilt es nicht als nicht-lateinische Alternative und dieser Schlüssel wird weggelassen.
full_name_non_latin (und full_name_latin) werden immer aus den einzelnen Vor-, Mittel- und Nachnamensbestandteilen rekonstruiert, wenn beide verfügbar sind — das Rohfeld „Full Name“ aus der OCR wird zur Gewährleistung der Konsistenz ignoriert.
Wenn preferred_characters=latin gesetzt ist, das Dokument jedoch ausschließlich nicht-lateinischen Text enthält (sodass die Felder der obersten Ebene nicht-lateinische Werte enthalten), führt Didit einen Transliterationsschritt durch und stellt first_name_latin, last_name_latin, middle_name_latin, full_name_latin, place_of_birth_latin und address_latin als lateinischen Fallback bereit.

{
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "extra_fields": {
    "first_name_non_latin": "Айна"
  }
}

last_name_non_latin fehlt, weil das Feld „Surname (Cyrillic)“ des Dokuments bei diesem Beispiel lateinische Zeichen zurückgegeben hat — es gab keinen echten nicht-lateinischen Nachnamen zum Extrahieren.

Beispiele

Approved — einwandfreier spanischer Personalausweis (alle Felder)

{
  "id_verifications": [
    {
      "status": "Approved",
      "document_type": "Identity Card",
      "document_subtype": "ID_CARD_GENERIC",
      "document_number": "SAMPLE-DOC-12345",
      "personal_number": "SAMPLE-PER-12345",
      "portrait_image": "https://<media-host>/.../portrait.jpg?signature=...",
      "front_image": "https://<media-host>/.../front.jpg?signature=...",
      "front_video": "https://<media-host>/.../front.mp4?signature=...",
      "back_image": "https://<media-host>/.../back.jpg?signature=...",
      "back_video": "https://<media-host>/.../back.mp4?signature=...",
      "full_front_image": "https://<media-host>/.../full_front.jpg?signature=...",
      "full_back_image": "https://<media-host>/.../full_back.jpg?signature=...",
      "front_image_camera_front": null,
      "back_image_camera_front": null,
      "front_image_camera_front_face_match_score": null,
      "back_image_camera_front_face_match_score": null,
      "front_image_quality_score": {
        "focus_score": 85.3,
        "brightness_score": 92.1,
        "brightness_issue": "ok",
        "is_document_fully_visible": true,
        "resolution_score": 72.4,
        "overall_score": 84.6
      },
      "back_image_quality_score": {
        "focus_score": 79.1,
        "brightness_score": 90.5,
        "brightness_issue": "ok",
        "is_document_fully_visible": true,
        "resolution_score": 72.4,
        "overall_score": 81.5
      },
      "date_of_birth": "1990-01-01",
      "age": 35,
      "expiration_date": "2031-06-02",
      "date_of_issue": "2021-06-02",
      "issuing_state": "ESP",
      "issuing_state_name": "Spain",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "gender": "M",
      "address": "Avda de Madrid 34",
      "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain",
      "place_of_birth": "Madrid",
      "marital_status": "SINGLE",
      "nationality": "ESP",
      "extra_fields": {},
      "mrz": {
        "document_number": "SAMPLE-DOC-12345",
        "surname": "DOE",
        "name": "JOHN",
        "birth_date": "900101",
        "expiry_date": "310602"
      },
      "parsed_address": {
        "street_1": "Avda de Madrid 34",
        "street_2": null,
        "city": "Madrid",
        "region": "Madrid",
        "country": "ES",
        "postal_code": "28822",
        "address_type": "Avda",
        "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain",
        "document_location": { "latitude": 40.4168, "longitude": -3.7038 },
        "raw_results": {
          "geometry": {
            "location": { "lat": 40.4168, "lng": -3.7038 },
            "location_type": "ROOFTOP"
          }
        },
        "is_best_match": true
      },
      "extra_files": [],
      "warnings": [],
      "node_id": "id_primary",
      "matches": []
    }
  ]
}

In Review — QR-Code auf einem Dokument nicht erkannt, das einen aufweisen sollte

Gekürzt — eine echte Antwort enthält immer den vollständigen Satz der oben gezeigten Felder.

{
  "id_verifications": [
    {
      "status": "In Review",
      "node_id": "id_primary",
      "document_type": "Identity Card",
      "document_subtype": "ID_CARD_GENERIC",
      "document_number": "SAMPLE-DOC-12345",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "warnings": [
        {
          "feature": "ID_VERIFICATION",
          "risk": "QR_NOT_DETECTED",
          "additional_data": null,
          "log_type": "warning",
          "short_description": "QR not detected",
          "long_description": "The system couldn't find or read the QR code on the document. This could be due to poor image quality or an unsupported document type.",
          "node_id": "id_primary"
        }
      ]
    }
  ]
}

Sicherheitshinweis

Die für Dokumentbilder und -videos zurückgegebenen signierten URLs sind temporär — sie laufen nach einem begrenzten Gültigkeitsfenster ab. Behandeln Sie sie als kurzlebig: Laden Sie zeitnah herunter, was Sie benötigen, und cachen oder machen Sie sie nicht öffentlich zugänglich. Typischerweise benötigt Ihre Anwendung nur status, eine Handvoll biografischer Felder und die Warnungen — speichern Sie so wenig wie möglich, um die Angriffsfläche bei einer künftigen Sicherheitsverletzung zu minimieren.

Authentifizierung

Verifizierung

Überwachung

Plattform

Ausweisverifizierungsbericht: Felder & Qualitätswerte

Übersicht

Wo er in API-Antworten erscheint

Schema

Felder der obersten Ebene

Bildqualitäts-Scores

Dokument-Liveness-Scores

Sitzungsübergreifende Übereinstimmungen

Statuswerte

Dokumente mit mehreren Schriftsystemen (lateinisch / nicht-lateinisch)

Wann Felder des alternativen Schriftsystems erscheinen

Beispiele

Approved — einwandfreier spanischer Personalausweis (alle Felder)

In Review — QR-Code auf einem Dokument nicht erkannt, das einen aufweisen sollte

Sicherheitshinweis

Verwandte Themen

​Übersicht

​Wo er in API-Antworten erscheint

​Schema

​Felder der obersten Ebene

​Bildqualitäts-Scores

​Dokument-Liveness-Scores

​Sitzungsübergreifende Übereinstimmungen

​Statuswerte

​Dokumente mit mehreren Schriftsystemen (lateinisch / nicht-lateinisch)

​Wann Felder des alternativen Schriftsystems erscheinen

​Beispiele

​Approved — einwandfreier spanischer Personalausweis (alle Felder)

​In Review — QR-Code auf einem Dokument nicht erkannt, das einen aufweisen sollte

​Sicherheitshinweis

​Verwandte Themen

Übersicht

Wo er in API-Antworten erscheint

Schema

Felder der obersten Ebene

Bildqualitäts-Scores

Dokument-Liveness-Scores

Sitzungsübergreifende Übereinstimmungen

Statuswerte

Dokumente mit mehreren Schriftsystemen (lateinisch / nicht-lateinisch)

Wann Felder des alternativen Schriftsystems erscheinen

Beispiele

Approved — einwandfreier spanischer Personalausweis (alle Felder)

In Review — QR-Code auf einem Dokument nicht erkannt, das einen aufweisen sollte

Sicherheitshinweis

Verwandte Themen