Datenmodelle in der Didit API-Referenz

Übersicht

Jedes Berichtsobjekt pro Funktion folgt der V3-Serializer-Struktur, die in service-didit-verification definiert ist. Dasselbe Objekt erscheint an drei Stellen, daher ist das Schema hier die einzige maßgebliche Quelle für alle drei:

GET /v3/session/{sessionId}/decision/: Jede Funktion wird als Array mit einem Pluralnamen zurückgegeben (id_verifications[], nfc_verifications[], liveness_checks[], face_matches[], poa_verifications[], phone_verifications[], email_verifications[], aml_screenings[], ip_analyses[], database_validations[], questionnaire_responses[], signatures[], bank_verifications[] (siehe Bankverifizierungsmethoden) sowie die entsprechenden KYB-Arrays registry_checks[], document_verifications[], key_people_checks[]).
Webhook-Payloads (status.updated, data.updated): gleiche Struktur innerhalb der decision-Hülle.
Eigenständige APIs: Antworten mit einem einzelnen Objekt (Gesichtssuche, Altersschätzung, biometrische Authentifizierung) verwenden dieselben Felder.

V3 hat Multi-Instance-Workflows eingeführt: Jedes Funktionsobjekt enthält eine node_id, die den Bericht dem Workflow-Graph-Knoten zuordnet, der ihn erzeugt hat. V2-Endpoints (im Singular kyc, face, aml usw.) bleiben abwärtskompatibel, geben aber nur die erste Instanz zurück.

Gemeinsame Felder

Jedes Berichtsobjekt enthält die folgenden Felder:

Feld	Typ	Beschreibung
`status`	string	Lebenszyklus-Status auf Funktionsebene, einer der Werte aus dem Status-Enum. Quelle: `common/config/choices.py:FeatureStatusChoices` (Zeilen 343-348). Der `status` der übergeordneten Sitzung auf oberster Ebene verwendet das umfassendere Sitzungs-Enum (`StatusChoices`, Zeilen 106-117).
`node_id`	string \| null	Kennung des Workflow-Graph-Knotens. Wird für Multi-Instance-Workflows in V3 befüllt; `null` bei Legacy-Sitzungen mit einer einzelnen Funktion.
`warnings`	Array aus Warnungsobjekten	Risikosignale, die auf diese Funktion und `node_id` gefiltert sind. Zurückgegeben von `Session.get_logs(...)` (`sessions/models/session.py:1611`).

Medienfelder (portrait_image, front_image, document_file, …) sind vorsignierte URLs mit begrenzter Gültigkeitsdauer. Laden Sie diese zeitnah herunter, statt die URL dauerhaft zu speichern. Beispiele zeigen sie als https://<media-host>/....

Warnungsobjekt

Wird in jedem warnings[]-Array zurückgegeben. Schema aus logs/serializers/log.py:8-65 (LogV3Serializer).

Feld	Typ	Nullbar	Beschreibung	Beispiel
`feature`	string (Enum)	Nein	Welche Funktion die Warnung ausgelöst hat. Werte aus `LogWarningChoices` (`common/config/choices.py:190-204`): `ID_VERIFICATION`, `NFC`, `LIVENESS`, `FACEMATCH`, `PROOF_OF_ADDRESS`, `PHONE`, `EMAIL`, `AML`, `LOCATION`, `DATABASE_VALIDATION`, `QUESTIONNAIRE`, `KYB_REGISTRY`, `KYB_DOCUMENTS`, `KYB_KEY_PEOPLE`.	`"ID_VERIFICATION"`
`risk`	string	Nein	Stabiler Risikocode (z. B. `DOCUMENT_EXPIRED`, `LOW_LIVENESS_SCORE`). Werte aus `logs/choices.py:RiskChoices`. Dient als Schlüssel in den Beschreibungstabellen.	`"DOCUMENT_EXPIRED"`
`additional_data`	object \| null	Ja	Risikospezifischer Kontext (z. B. Score-Schwellenwerte, übereinstimmende Felder). Die Struktur variiert je nach Risikocode.	`{ "score": 42.1, "threshold": 70 }`
`log_type`	string (Enum)	Nein	Einer von `error`, `warning`, `information`. Aus `LogTypeChoices` (`common/config/choices.py:207-210`).	`"error"`
`short_description`	string	Nein	Lesbare Bezeichnung des Risikos. Aus `logs/choices.py:RISK_SHORT_DESCRIPTIONS`.	`"Document expired"`
`long_description`	string	Nein	Längere, lesbare Erklärung, geeignet für Oberflächen, die Endbenutzern angezeigt werden. Aus `logs/choices.py:RISK_LONG_DESCRIPTIONS`.	`"The document's expiration date has passed, rendering it no longer valid for use."`
`node_id`	string \| null	Ja	Workflow-Graph-Knoten, dem die Warnung zugeordnet wurde. `null` bei Legacy-V2-Logs ohne `node_id`.	`"first_id_verification"`

{
  "feature": "ID_VERIFICATION",
  "risk": "DOCUMENT_EXPIRED",
  "additional_data": null,
  "log_type": "error",
  "short_description": "Document expired",
  "long_description": "The document's expiration date has passed, rendering it no longer valid for use.",
  "node_id": "first_id_verification"
}

Berichtsobjekte

Die übrigen Abschnitte behandeln jedes Berichtsobjekt pro Funktion. Der Text der H3-Überschriften ist bewusst stabil, damit andere Dokumente direkt darauf verlinken können.

Ausweisverifizierung

Wird für jedes KYC- bzw. Ausweisdokument zurückgegeben, das ein Benutzer einreicht. Erscheint als id_verifications[] in GET /v3/session/{sessionId}/decision/ und innerhalb des Felds kyc der V2-Antworten. Quelle: kyc/serializers/kyc.py:383-414 (IDVerificationV3Serializer, erweitert IDVerificationV2Serializer aus kyc/serializers/kyc.py:320-380).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`document_type`	string	Ja	Für Menschen lesbare Dokumentklasse (`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`). Quelle: `DOC_TYPE_MAPPING` (`common/config/choices.py:1275-1289`).	`"Passport"`
`document_subtype`	string	Ja	Code des Dokumentuntertyps aus dem Dokumenteregister von Didit, auf die von den Dokumenteinstellungen des Workflows akzeptierten Dokumente gefiltert. Regionsspezifische Dokumente enthalten die Region. Vollständige Codeliste: Dokumentuntertypen.	`"QUEENSLAND_DRIVER_LICENSE_GENERIC"`
`document_number`	string	Ja	Per OCR extrahierte Dokumentnummer.	`"AB1234567"`
`personal_number`	string	Ja	Per OCR extrahierte persönliche oder nationale Kennung.	`"99999999R"`
`portrait_image`	string (URL)	Ja	Vorsignierte URL zum Gesichtsausschnitt.	`"https://<media-host>/.../portrait.jpg?..."`
`front_image`	string (URL)	Ja	Vorsignierte URL zur bereinigten Dokumentvorderseite.	`"https://<media-host>/.../front.jpg?..."`
`front_video`	string (URL)	Ja	Vorsignierte URL zum Video der Vorderseitenaufnahme (sofern verfügbar).	`"https://<media-host>/.../front.mp4?..."`
`back_image`	string (URL)	Ja	Vorsignierte URL zur bereinigten Dokumentrückseite.	`"https://<media-host>/.../back.jpg?..."`
`back_video`	string (URL)	Ja	Vorsignierte URL zum Video der Rückseitenaufnahme.	`null`
`full_front_image`	string (URL)	Ja	Unbeschnittene Aufnahme (Vollbild) der Vorderseite.	`"https://<media-host>/.../full_front.jpg?..."`
`full_back_image`	string (URL)	Ja	Unbeschnittene Aufnahme (Vollbild) der Rückseite.	`null`
`front_image_camera_front`	string (URL)	Ja	Bild der Frontkamera, das zeitgleich mit der Aufnahme der Dokumentvorderseite aufgenommen wurde.	`null`
`back_image_camera_front`	string (URL)	Ja	Bild der Frontkamera, das zeitgleich mit der Aufnahme der Dokumentrückseite aufgenommen wurde.	`null`
`front_image_camera_front_face_match_score`	float (0-100)	Ja	Ähnlichkeit zwischen dem Dokumentporträt und der Aufnahme der Frontkamera.	`null`
`back_image_camera_front_face_match_score`	float (0-100)	Ja	Wie oben, jedoch für die Rückseitenaufnahme.	`null`
`document_selfie_face_matches`	array	Ja	Frühere Sitzungen oder Einträge der Gesichts-Sperrliste, die dem Selfie aus der Dokumentaufnahme entsprechen. Gleiches Eintragsformat wie `liveness_checks[].matches`. `null`, wenn die Suche nicht ausgeführt wurde, `[]`, wenn nichts übereinstimmte.	`null`
`front_image_quality_score`	object	Ja	Qualitätsmetriken für das Vorderseitenbild: Werte von 0 bis 100 (`focus_score`, `brightness_score`, `resolution_score`, `overall_score`) sowie `brightness_issue` (`ok`, `too_dark`, `too_bright`) und `is_document_fully_visible` (Boolean).	`{ "focus_score": 91.0, "overall_score": 88.5 }`
`back_image_quality_score`	object	Ja	Gleiche Struktur wie `front_image_quality_score`.	`null`
`date_of_birth`	string (YYYY-MM-DD)	Ja	Per OCR extrahiertes Geburtsdatum.	`"1990-05-12"`
`age`	integer	Ja	Berechnetes Alter in Jahren zum Zeitpunkt der Extraktion.	`35`
`expiration_date`	string (YYYY-MM-DD)	Ja	Ablaufdatum des Dokuments.	`"2032-05-11"`
`date_of_issue`	string (YYYY-MM-DD)	Ja	Ausstellungsdatum des Dokuments.	`"2022-05-11"`
`issuing_state`	string (ISO 3166-1 alpha-3)	Ja	Ländercode des ausstellenden Landes.	`"ESP"`
`issuing_state_name`	string	Ja	Lokalisierter Name des ausstellenden Landes.	`"Spain"`
`first_name`	string	Ja	Per OCR extrahierte Vornamen.	`"María"`
`last_name`	string	Ja	Per OCR extrahierte Nachnamen.	`"García López"`
`full_name`	string	Ja	Vollständiger normalisierter Name (vom Anbieter geliefert).	`"María García López"`
`gender`	string	Ja	`M`, `F` oder ein anderer vom Anbieter gelieferter Wert.	`"F"`
`address`	string	Ja	Rohe, per OCR extrahierte Adresszeile.	`"Calle Mayor 1, 28001 Madrid"`
`formatted_address`	string	Ja	Geocodierte bzw. formatierte Adresse (sofern auswertbar).	`"Calle Mayor 1, 28001 Madrid, Spain"`
`parsed_address`	object	Ja	Strukturierte, geocodierte Adresse: `street_1`, `street_2`, `city`, `region`, `country`, `postal_code`, `address_type`, `formatted_address`, `document_location` (`{latitude, longitude}`), `raw_results`, `is_best_match`. Quelle: `kyc/utils/address.py:147-197`.	`{ "street_1": "Calle Mayor 1", "city": "Madrid", "postal_code": "28001", "country": "ES" }`
`place_of_birth`	string	Ja	Per OCR extrahierter Geburtsort.	`"Madrid"`
`marital_status`	string	Ja	Sofern auslesbar.	`null`
`nationality`	string (ISO 3166-1 alpha-3)	Ja	Per OCR extrahierte Staatsangehörigkeit.	`"ESP"`
`extra_fields`	object	Ja	Dokumenttypspezifische Felder, die das kanonische Schema nicht abdeckt (z. B. Fahrerlaubnisklassen).	`{ "DL Class": "B" }`
`mrz`	object	Ja	Geparste MRZ-Felder, sofern vorhanden (`document_number`, `birth_date`, `expiry_date`, `surname`, `given_names`, …).	`{ "document_number": "AB1234567", "surname": "GARCIA", "given_names": "MARIA" }`
`extra_files`	array of strings (URL)	Nein	Vorsignierte URLs zu allen zusätzlich hochgeladenen Dateien.	`[]`
`matches`	array of objects	Nein	Dokumentübereinstimmungen über Sitzungen hinweg. Jedes Element: `{ session_id, session_number, vendor_data, verification_date, user_details: { name, document_type, document_number }, status, is_blocklisted, api_service, front_image_url }`. `front_image_url` ist vorsigniert.	`[]`
`verification_method`	string	Nein	Welche Methode der Ausweisverifizierung diese Zeile erzeugt hat: `document`, `id_lookup` oder `wallet`. Immer `document` bei einem fotografierten Dokument, einschließlich aller Sitzungen, die erstellt wurden, bevor die anderen Methoden existierten.	`"id_lookup"`
`assurance`	string	Nein	Aus `verification_method` abgeleitete Assurance-Stufe: `documentary`, `data_match` oder `cryptographic`.	`"data_match"`
`wallet_provider`	string \| null	Ja	Wallet-ID aus dem Katalog, wenn eine Wallet diese Zeile erzeugt hat (`mitid`, `bankid_se`, `itsme`, …). Andernfalls `null`.	`"mitid"`
`fallback_from`	object \| null	Ja	Grund, warum eine Nicht-Dokument-Methode den ID-Schritt beendet hat: `{ method, reason, action }`. Wird gesetzt, wenn eine Lookup-Abfrage oder eine Wallet-Anmeldung fehlgeschlagen ist: in der abgelehnten Zeile, wenn die Schalterstellung des Landes `decline` war (`action: "decline"`), und bei der Dokumentenverifizierung, mit der der Benutzer fortfährt, wenn die Schalterstellung `fallback_to_document` war (`action: "fallback_to_document"`). `null`, wenn kein früherer Nicht-Dokument-Fehler erfasst ist.	`{ "method": "id_lookup", "reason": "no_match", "action": "decline" }`
`id_lookup`	object \| null	Ja	Quellennachweis, nur vorhanden, wenn `verification_method` `id_lookup` ist: `source` (die exakt abgefragte Quelle, in den meisten Ländern ein staatliches Register, in einigen eine Auskunftei oder eine Melderegister-Datei), `checked_at`, `attempts`, `max_attempts`, `outcome` (`match`, `partial_match`, `no_match`, `provider_error`, `format_rejected`), `comparison[]` (`{ field, label, provided, record, result }`; `field` ist einer der Werte `identification_number`, `full_name`, `date_of_birth`, `address`, und `result` ist `match`, `partial` oder `no_match`; frühere Releases können eine Zeile `provider` mit `error` enthalten), `source_errors[]` (aktuelles Staging: separate Quelldiagnosen; Produktionsrollout bestätigen), `registry_portrait` (vorsignierte URL, nur für Quellen, die eine solche zurückgeben) und `face_match_score`.	siehe unten
`wallet_verification`	object \| null	Ja	Credential-Nachweis, nur vorhanden, wenn `verification_method` `wallet` ist: `provider`, `provider_name`, `issuing_authority`, `issuing_country`, `credential_type`, `level_of_assurance` (`low`, `substantial`, `high`), `verified_at`, `signature_valid`, `attributes` (was die Wallet geteilt hat), `portrait` (vorsignierte URL, wenn die Wallet ein Porträt teilt) und `face_match_score`.	siehe unten
`document_liveness`	object \| null	Ja	Dokument-Liveness-Scores je Betrugstyp (`portrait_replace`, `printed_copy`, `screen_replay`), unabhängig davon gemeldet, ob eine Warnung ausgelöst wurde. Je Eintrag: `score` (0–100, höher = wahrscheinlicher echt; der niedrigere Wert, also der Wert, den die Entscheidung verwendet hat), `front`, `back`, `decline_threshold`, `review_threshold`, `bucket` (`approve`, `review`, `decline` oder `null`). Schwellenwerte und Kategorie werden zum Zeitpunkt der Bewertung gespeichert. Alle drei sind `null`, wenn historische Bewertungsnachweise nicht verfügbar sind, während gespeicherte Scores sichtbar bleiben. `null`, wenn die Prüfung nicht ausgeführt wurde. Siehe Dokument-Liveness-Scores. Nur V3.	`{ "portrait_replace": { "score": 96.46, "bucket": "approve" } }`
`node_id`	string \| null	Ja	Bezeichner des Workflow-Knotens (V3).	`"first_id_verification"`
`warnings`	array	Nein	Siehe Warnungsobjekt.	`[]`
`region`	string	Ja	Region oder Bundesstaat des ausstellenden Landes, sofern das Dokument eine solche angibt.	`"CA"`
`extracted_data`	object	Ja	Momentaufnahme der aus dem Dokument extrahierten Daten, die der Person zur Prüfung angezeigt und neben den bestätigten Werten aufbewahrt wurden, damit Sie beide vergleichen können. `null`, wenn die Person nicht zur Prüfung aufgefordert wurde.
`barcodes`	Array von Objekten	Nein	Aus den Barcodes des Dokuments gelesene Daten, ein Eintrag je Barcode mit `type`, `position`, `data`, `data_raw` und `side`. `[]`, wenn keine vorhanden sind.	`[]`

{
  "status": "Approved",
  "document_type": "Passport",
  "document_subtype": "PASSPORT_GENERIC",
  "document_number": "AB1234567",
  "personal_number": "99999999R",
  "portrait_image": "https://<media-host>/.../portrait.jpg?signature=...",
  "front_image": "https://<media-host>/.../front.jpg?signature=...",
  "front_video": null,
  "back_image": "https://<media-host>/.../back.jpg?signature=...",
  "back_video": null,
  "full_front_image": "https://<media-host>/.../full_front.jpg?signature=...",
  "full_back_image": null,
  "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": 91.0,
    "brightness_score": 88.0,
    "brightness_issue": "ok",
    "is_document_fully_visible": true,
    "resolution_score": 95.0,
    "overall_score": 88.5
  },
  "back_image_quality_score": null,
  "date_of_birth": "1990-05-12",
  "age": 35,
  "expiration_date": "2032-05-11",
  "date_of_issue": "2022-05-11",
  "issuing_state": "ESP",
  "issuing_state_name": "Spain",
  "first_name": "María",
  "last_name": "García López",
  "full_name": "María García López",
  "gender": "F",
  "address": "Calle Mayor 1, 28001 Madrid",
  "formatted_address": "Calle Mayor 1, 28001 Madrid, Spain",
  "parsed_address": { "street_1": "Calle Mayor 1", "street_2": null, "city": "Madrid", "region": "Madrid", "postal_code": "28001", "country": "ES", "address_type": "Calle" },
  "place_of_birth": "Madrid",
  "marital_status": null,
  "nationality": "ESP",
  "extra_fields": {},
  "mrz": {
    "document_number": "AB1234567",
    "surname": "GARCIA",
    "given_names": "MARIA",
    "birth_date": "900512",
    "expiry_date": "320511"
  },
  "extra_files": [],
  "matches": [],
  "node_id": "first_id_verification",
  "verification_method": "document",
  "assurance": "documentary",
  "wallet_provider": null,
  "fallback_from": null,
  "id_lookup": null,
  "wallet_verification": null,
  "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"
    }
  },
  "warnings": []
}

Dasselbe Objekt bei einer Nicht-Dokument-Methode. Nur die methodenspezifischen Schlüssel ändern sich: Alles, was eine Dokumentenauslesung ausfüllt, wird stattdessen aus dem Registerdatensatz oder den Wallet-Attributen befüllt, und die nicht zutreffenden Schlüssel sind null.

{
  "status": "Approved",
  "issuing_state": "ZAF",
  "first_name": "Thabo",
  "last_name": "Mokoena",
  "full_name": "Thabo Mokoena",
  "date_of_birth": "1991-06-15",
  "personal_number": "9106155043088",
  "node_id": "first_id_verification",
  "verification_method": "id_lookup",
  "assurance": "data_match",
  "wallet_provider": null,
  "fallback_from": null,
  "id_lookup": {
    "source": "Department of Home Affairs",
    "checked_at": "2026-09-04T09:12:44Z",
    "attempts": 1,
    "max_attempts": 2,
    "outcome": "match",
    "comparison": [
      { "field": "identification_number", "label": "ID number", "provided": "9106155043088", "record": "9106155043088", "result": "match" },
      { "field": "full_name", "label": "Full name", "provided": "Thabo Mokoena", "record": "Thabo Mokoena", "result": "match" },
      { "field": "date_of_birth", "label": "Date of birth", "provided": "1991-06-15", "record": "1991-06-15", "result": "match" }
    ],
    "registry_portrait": "https://<media-host>/.../registry_portrait.jpg?signature=...",
    "face_match_score": 96.4
  },
  "wallet_verification": null,
  "warnings": []
}

{
  "status": "Approved",
  "issuing_state": "DNK",
  "first_name": "Freja",
  "last_name": "Nielsen",
  "full_name": "Freja Nielsen",
  "date_of_birth": "1988-03-02",
  "node_id": "first_id_verification",
  "verification_method": "wallet",
  "assurance": "cryptographic",
  "wallet_provider": "mitid",
  "fallback_from": null,
  "id_lookup": null,
  "wallet_verification": {
    "provider": "mitid",
    "provider_name": "MitID",
    "issuing_authority": "Danish Agency for Digital Government",
    "issuing_country": "DNK",
    "credential_type": "person_identification",
    "level_of_assurance": "substantial",
    "verified_at": "2026-09-04T09:12:44Z",
    "signature_valid": true,
    "attributes": {
      "full_name": "Freja Nielsen",
      "date_of_birth": "1988-03-02",
      "cpr_alias": "b0f1c2d3-e4f5-4678-9abc-def012345678"
    },
    "portrait": null,
    "face_match_score": null
  },
  "warnings": []
}

NFC-Verifizierung

Wird für jede Chip-Auslesung anhand eines Ausweisdokuments zurückgegeben: ein ICAO-9303-ePassport oder eID-Chip oder eine japanische My Number Card, ausgelesen über JPKI (chip_protocol: "jpki"). Erscheint als nfc_verifications[] in GET /v3/session/{sessionId}/decision/ (eine pro übergeordnetem KYC-Datensatz). Quelle: kyc/serializers/epassport.py:121-139 (NFCV3Serializer, erweitert NFCV2Serializer aus kyc/serializers/epassport.py:83-118).

Feld	Typ	Null zulässig	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`portrait_image`	string (URL)	Ja	Vorsignierte URL zum aus dem Chip extrahierten Gesichtsbild.	`"https://<media-host>/.../nfc_portrait.jpg?..."`
`signature_image`	string (URL)	Ja	Vorsignierte URL zum aus dem Chip extrahierten Unterschriftsbild (sofern auf dem Chip gespeichert).	`null`
`chip_data`	object	Ja	Aus den Datengruppen des Chips (Data Groups) geparste persönliche Daten, flach dargestellt (`kyc/utils/epassport.py:165-212`): `dgs` (gelesene Datengruppen), `surname`, `name`, `country`, `nationality`, `birth_date` (`YYYY-MM-DD`), `expiry_date` (`YYYY-MM-DD`), `sex` (`M`/`F`), `document_type` (MRZ-Dokumentcode), `document_number`, `optional_data`, MRZ-Prüfziffern (`birth_date_hash`, `expiry_date_hash`, `document_number_hash`, `optional_data_hash`, `final_hash`), `mrz_string`, `mrz_type` (`TD1`/`TD2`/`TD3`). Außerdem `place_of_birth` und `address` (sowie `full_name` / `full_name_non_latin` bei nicht lateinischen Namen), wenn der Chip DG11 enthält. Diese Schlüssel fehlen andernfalls. `null`, wenn der NFC-Schritt übersprungen wurde.	`{ "document_number": "AB1234567", "name": "MARIA" }`
`authenticity`	object	Ja	`{ sod_integrity, dg_integrity }`; `null` bei einer JPKI-Auslesung. `sod_integrity` prüft, ob die Signatur des Document Security Object (SOD) auf eine gültige CSCA des ausstellenden Landes zurückführt (und der DSC weder widerrufen noch abgelaufen ist). `dg_integrity` prüft, ob die Hashes jeder Datengruppe mit dem SOD übereinstimmen. Beide `true` bedeuten, dass der Chip echt und unverändert ist.	`{ "sod_integrity": true, "dg_integrity": true }`
`certificate_summary`	object	Ja	Zusammenfassung des Zertifikats des Dokumentsignierers (`kyc/utils/epassport.py:338-348`): `issuer`, `subject`, `serial_number` (Ganzzahl), `not_valid_before`, `not_valid_after` (`YYYY-MM-DD HH:MM:SS`), außerdem ein `validation`-Objekt `{ csca_verified, dsc_revoked, dsc_expired, csca_expired }` (`kyc/views/epassport.py:86`).	`{ "issuer": "Common Name: CSCA SPAIN, Country: ES", "not_valid_after": "2031-02-18 10:21:11" }`
`node_id`	string \| null	Ja	Workflow-Knoten-Kennung (V3).	`"first_nfc"`
`is_nfc_skipped`	boolean	Nein	`true`, wenn dieser NFC-Schritt bewusst übersprungen statt gelesen wurde; `skip_reason` gibt den Grund an.	`false`
`skip_reason`	string	Ja	Grund für das Überspringen des Schritts, nur gesetzt, wenn `is_nfc_skipped` `true` ist. Zulässig sind `USER_SKIPPED`, `DOCUMENT_WITHOUT_CHIP`, `CHIP_CERTIFICATE_UNAVAILABLE`, `DEVICE_WITHOUT_NFC`, `INTEGRATION_WITHOUT_NFC_ACCESS`, `MRZ_KEY_UNAVAILABLE` und `JPKI_UNAVAILABLE`; siehe Gründe für das Überspringen. Die Entscheidungs-Payload enthält außerdem eine sitzungsweite `nfc_skip_reason` mit derselben Taxonomie, die NFC-Schritte abdeckt, die umgangen wurden, bevor ein Bericht erstellt wurde.	`null`
`chip_protocol`	string	Nein	Wie der Chip gelesen wird: `icao` (ICAO-9303-ePassport- oder eID-Chip) oder `jpki` (Japan My Number Card). Bei `jpki` sind `portrait_image`, `signature_image`, `chip_data`, `authenticity` und `certificate_summary` `null`. Wird auch bei übersprungenen Schritten gesetzt.	`"icao"`
`jpki`	object	Ja	Was ein Lesevorgang der My Number Card belegt: `certificate_types`, `chain_valid`, `signature_valid`, `revocation_status` (`good`, `revoked` oder `unchecked`), `ca_generation`, `certificate_expires_at`, `certificates[]`, `attributes` (Name, Geburtsdatum, Geschlecht und Adresse aus dem Signaturzertifikat), `attributes_match_ocr` und `mismatched_attributes`. Enthält niemals die Zertifikate, ihre Seriennummern oder die Signaturen. `null` bei ICAO-Chips, bei übersprungenen Schritten und wenn der Schritt ohne jeden Kartenlesevorgang abgeschlossen wurde. Siehe JPKI-Felder.	`null`
`warnings`	array	Nein	Siehe Warnobjekt.	`[]`

{
  "status": "Approved",
  "portrait_image": "https://<media-host>/.../nfc_portrait.jpg?signature=...",
  "signature_image": null,
  "chip_data": {
    "dgs": ["DG1", "DG2", "DG11"],
    "surname": "GARCIA LOPEZ",
    "name": "MARIA",
    "country": "ESP",
    "nationality": "ESP",
    "birth_date": "1990-05-12",
    "expiry_date": "2032-05-11",
    "sex": "F",
    "document_type": "P",
    "document_number": "AB1234567",
    "optional_data": "",
    "birth_date_hash": "4",
    "expiry_date_hash": "7",
    "document_number_hash": "3",
    "optional_data_hash": "",
    "final_hash": "8",
    "mrz_string": "P<ESPGARCIA<LOPEZ<<MARIA<<<<<<<<<<<<<<<<<<<<AB1234567ESP9005124F3205117<<<<<<<<<<<<<<08",
    "mrz_type": "TD3",
    "place_of_birth": "MADRID",
    "address": "CALLE MAYOR 1, MADRID"
  },
  "authenticity": { "sod_integrity": true, "dg_integrity": true },
  "certificate_summary": {
    "issuer": "Common Name: CSCA SPAIN, Organization: DIRECCION GENERAL DE LA POLICIA, Country: ES",
    "subject": "Common Name: DS n-eID SPAIN 2, Organizational Unit: PASSPORT, Organization: DIRECCION GENERAL DE LA POLICIA, Country: ES",
    "serial_number": 118120836164494130086420187336801405660,
    "not_valid_before": "2020-11-18 10:21:11",
    "not_valid_after": "2031-02-18 10:21:11",
    "validation": {
      "csca_verified": true,
      "dsc_revoked": false,
      "dsc_expired": false,
      "csca_expired": false
    }
  },
  "node_id": "first_nfc",
  "is_nfc_skipped": false,
  "skip_reason": null,
  "chip_protocol": "icao",
  "jpki": null,
  "warnings": []
}

Liveness-Prüfung

Wird pro Liveness-Sitzung zurückgegeben. Erscheint als liveness_checks[] in GET /v3/session/{sessionId}/decision/. Quelle: face/serializers/face.py:301-320 (LivenessV3Serializer, erweitert LivenessV2Serializer unter face/serializers/face.py:216-298).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`method`	string (enum)	Ja	`ACTIVE_3D`, `FLASHING` oder `PASSIVE` (`LivenessMethodChoices`, `common/config/choices.py:514-517`). Die passive Prüfung läuft, wenn Desktop-Sitzungen erlaubt sind und der Benutzer an einem Desktop ist.	`"PASSIVE"`
`score`	float (0-100)	Ja	Liveness-Konfidenz, auf 2 Dezimalstellen gerundet.	`92.41`
`reference_image`	string (URL)	Ja	Presigned-URL zum Referenz-Gesichtsausschnitt des Benutzers.	`"https://<media-host>/.../reference.jpg?..."`
`video_url`	string (URL)	Ja	Presigned-URL zur Liveness-Aufnahme, wenn die Erfassung eine Aufnahme gespeichert hat, sowohl für aktive als auch für passive Liveness. `null`, wenn die Sitzung keine Aufnahme behalten hat.	`"https://<media-host>/.../liveness.webm?..."`
`age_estimation`	float	Ja	Geschätztes Alter (in Jahren) des größten Gesichts im Referenzbild.	`34.2`
`matches`	array of objects	Nein	Sitzungsübergreifende Gesichtsabgleiche. Jedes Element: `{ session_id, session_number, similarity_percentage, vendor_data, vendor_user_id, biometric_template_id, verification_date, user_details: { full_name, document_type, document_number }, match_image_url, status, is_blocklisted, is_allowlisted, api_service, source }`. `source` ist `session`, `imported`, `list_entry` oder `retained_template`. Ein Abgleich mit einer gespeicherten Vorlage hat `vendor_user_id`, `vendor_data` und `biometric_template_id`; seine Felder für Sitzung, Bild, Identitätsdetails, Status und API-Service sind `null`.	`[]`
`face_quality`	float (0-100)	Ja	Qualitätswert des Gesichts bei passiver Liveness (in Prozent normalisiert).	`87.50`
`face_luminance`	float (0-100)	Ja	Helligkeitswert des Gesichts bei passiver Liveness (von 0-255 in Prozent normalisiert).	`54.12`
`node_id`	string \| null	Ja	Workflow-Knoten-Kennung (V3).	`"first_liveness"`
`warnings`	array	Nein	Siehe Warnobjekt.	`[]`

{
  "status": "Approved",
  "method": "PASSIVE",
  "score": 92.41,
  "reference_image": "https://<media-host>/.../reference.jpg?signature=...",
  "video_url": null,
  "age_estimation": 34.2,
  "matches": [],
  "face_quality": 87.50,
  "face_luminance": 54.12,
  "node_id": "first_liveness",
  "warnings": []
}

Eine PASSIVE-Sitzung gibt dieses Feld zurück, wenn ihre Erfassung eine Aufnahme gespeichert hat, und null, wenn die Sitzung keine Aufnahme behalten hat. Das Beispiel oben zeigt eine Sitzung, die keine behalten hat.

Gesichtsabgleich

Wird pro Gesichtsvergleich zurückgegeben (typischerweise das Liveness-Gesicht des Benutzers gegen das Dokumentporträt). Erscheint als face_matches[] in GET /v3/session/{sessionId}/decision/. Quelle: face/serializers/face.py:367-389 (FaceMatchV3Serializer, erweitert FaceMatchV2Serializer unter face/serializers/face.py:323-364).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`score`	float (0-100)	Ja	Ähnlichkeit, auf 2 Dezimalstellen gerundet. Liefert der Anbieter nur einen `unmatched_faces[].Confidence`-Wert, wird dieser in `100 - confidence` umgerechnet.	`97.83`
`source_image_session_id`	string (UUID)	Ja	Die ID der Sitzung, deren gespeichertes Porträt das Ausgangsbild (Referenzbild) geliefert hat. Gesetzt in porträtbasierten Abläufen, also bei biometrischer Authentifizierung oder einem Porträt, das bei der Sitzungserstellung übergeben wurde. `null`, wenn die Referenz das Dokumentporträt aus derselben Sitzung ist.	`null`
`source_image`	string (URL)	Ja	Presigned-URL zum Ausgangsbild (Referenzbild). In der Regel ist das das Dokumentporträt, bei biometrischen Authentifizierungsabläufen das gespeicherte Porträt.	`"https://<media-host>/.../source.jpg?..."`
`target_image`	string (URL)	Ja	Presigned-URL zum Zielbild (Live-Gesicht), das während der Liveness-Prüfung erfasst wurde.	`"https://<media-host>/.../target.jpg?..."`
`node_id`	string \| null	Ja	Workflow-Knoten-Kennung (V3).	`"first_face_match"`
`warnings`	array	Nein	Siehe Warnobjekt.	`[]`
`face_coverage`	object	Ja	Ob `eyes`, `mouth` und `face` im erfassten Bild verdeckt sind. Jede Region hat `covered`, `calibrated` und `visibility_score`. `calibrated: false` bedeutet einen Schattenhinweis, auf den keine Warnung reagiert. Wird nur von `GET /v3/session/{sessionId}/decision/` zurückgegeben, niemals in Webhook-Payloads.	`{ "eyes": { "covered": false, "calibrated": true, "visibility_score": 0.98 } }`

{
  "status": "Approved",
  "score": 97.83,
  "source_image_session_id": null,
  "source_image": "https://<media-host>/.../source.jpg?signature=...",
  "target_image": "https://<media-host>/.../target.jpg?signature=...",
  "node_id": "first_face_match",
  "warnings": []
}

Gesichtssuche

Wird von der eigenständigen Gesichtssuche-API (POST /v3/face-search/) zurückgegeben. Die Gesichtssuche erscheint in /v3/session/{sessionId}/decision/ niemals als Array mit mehreren Einträgen. Wenn sie mit save_api_request=true gespeichert wird, erscheint die Sitzung dort als Eintrag FACE_SEARCH in features[] sowie als Element liveness_checks[], das die gespeicherten matches enthält. Quellen: apis/serializers/face_search.py:8-79 (FaceSearchResponseSerializer, das FaceSearchDetailsSerializer umschließt); Treffer-Dictionaries werden in face/utils/utils.py:869-884 erstellt. Antwort auf oberster Ebene:

Feld	Typ	Nullwert möglich	Beschreibung	Beispiel
`request_id`	string (UUID)	Nein	Die gespeicherte Sitzungs-ID, wenn `save_api_request=true` gesetzt ist (nutzbar mit `GET /v3/session/{sessionId}/decision/`); andernfalls eine temporäre Korrelations-UUID.	`"4a1c2c4e-8b1b-4d6a-91b5-ee9a1f3a2c7f"`
`face_search`	Objekt	Nein	Die Nutzlast mit den Suchdetails, siehe Felder unten.	—
`vendor_data`	string	Ja	Aus der Anfrage zurückgegebener `vendor_data`-Wert.	`null`
`metadata`	Objekt	Ja	Aus der Anfrage zurückgegebene `metadata`.	`null`
`created_at`	string (ISO 8601)	Nein	Serverseitiger Zeitstempel der Anfrage.	`"2026-06-12T01:04:42.763237+00:00"`

face_search-Objekt:

Feld	Typ	Nullwert möglich	Beschreibung	Beispiel
`status`	string	Nein	`Declined` nur, wenn eine Warnung `FACE_IN_BLOCKLIST` oder `POSSIBLE_FACE_IN_BLOCKLIST` ausgelöst wurde; andernfalls `Approved`. Doppelte Treffer allein führen niemals zur Ablehnung (`apis/views/face_search.py:242-248`).	`"Approved"`
`total_matches`	Ganzzahl	Nein	Anzahl der zurückgegebenen Treffer in `matches[]` (0–5).	`1`
`matches`	Array aus Gesichtssuche-Treffer-Objekten	Nein	Bis zu 5 Treffer oberhalb der Ähnlichkeitsschwelle, absteigend nach Ähnlichkeit sortiert (Einträge aus der Sperrliste zuerst, mit `search_type=blocklisted_or_approved`).	`[…]`
`user_image`	Objekt	Nein	Erkennungsergebnis für das eingereichte Bild in der Form `{ entities: [{ bbox, confidence }], best_angle }`, mit einem Element pro erkanntem Gesicht.	`{ "entities": [{ "bbox": [40, 40, 120, 120], "confidence": 0.73 }], "best_angle": 0 }`
`warnings`	Array aus Objekten	Nein	Verkürzte Warnungsstruktur für diese eigenständige API, ohne `node_id`. Der Serializer-Vertrag deklariert `{ risk, additional_data, log_type, short_description, long_description }` (`apis/serializers/face_search.py:49-54`); die Laufzeit-Nutzlast enthält außerdem `feature`, immer `"LIVENESS"` (`apis/views/face_search.py:332-341`).	`[]`

Gesichtssuche-Treffer-Objekt

Feld	Typ	Nullwert möglich	Beschreibung	Beispiel
`session_id`	string (UUID)	Ja	Die zugeordnete Verifizierungssitzung. `null`, wenn `source` den Wert `imported`, `list_entry` oder `retained_template` hat.	`"a3f2a6f1-…"`
`session_number`	Ganzzahl	Ja	Für die Konsole lesbare Nummer der zugeordneten Sitzung; `null` bei Treffern ohne Sitzung.	`1024`
`similarity_percentage`	float (0–100)	Nein	Ähnlichkeit zwischen dem eingereichten Gesicht und dem gefundenen Gesicht.	`96.42`
`source`	string (Enum)	Nein	Herkunft des gefundenen Gesichts: `session` (Verifizierungssitzung oder gespeicherter eigenständiger Aufruf), `imported` (direkter Upload eines Gesichts im Benutzerprofil), `list_entry` (Gesicht, das einer Liste zugeordnet ist), `retained_template` (bildfreies biometrisches Template, das nach dem Löschen der Quellsitzung aufbewahrt wurde).	`"session"`
`vendor_data`	string	Ja	`vendor_data` der zugeordneten Sitzung bzw. des verknüpften Benutzers bei Treffern vom Typ `imported` und `retained_template`.	`"user-12345"`
`vendor_user_id`	string (UUID)	Ja	Der verknüpfte Benutzer. `null` bei `list_entry`-Treffern und bei Sitzungen ohne Benutzer.	`"2f7c1a9e-…"`
`biometric_template_id`	string (UUID)	Ja	Die aufbewahrte Vorlage, die übereinstimmte. Nur bei `retained_template`-Treffern gesetzt; verwenden Sie es mit `GET`/`DELETE /v3/biometric-templates/{id}/`.	`null`
`verification_date`	string (ISO 8601)	Ja	Zeitpunkt der Aufnahme des gefundenen Gesichts bzw. der Aufbewahrung eines `retained_template`; `null` bei `list_entry`-Treffern.	`"2024-11-04T09:14:02Z"`
`user_details`	Objekt	Ja	`{ full_name, document_type, document_number }` aus der Dokumentenverifizierung der zugeordneten Sitzung; bei `imported`-Treffern ist nur `full_name` gesetzt; `null`, wenn keine Identitätsdaten vorliegen, und bei `retained_template`-Treffern immer `null`.	`{ "full_name": "María García López", "document_type": "Passport", "document_number": "AB1234567" }`
`match_image_url`	string (URL)	Ja	Referenzgesicht des gefundenen Benutzers: signierte URL, wenn `save_api_request=true`, andernfalls der rohe Speicherpfad. Bei `retained_template`-Treffern immer `null`, da kein Bild gespeichert ist.	`"https://<media-host>/.../matched.jpg?..."`
`status`	string	Ja	Verifizierungsstatus der zugeordneten Sitzung (siehe Status-Enum); `null` bei Treffern ohne Sitzung.	`"Approved"`
`is_blocklisted`	Boolean	Nein	Ob das gefundene Gesicht in Ihrer Gesichts-Sperrliste steht. Bei `retained_template`-Treffern immer `false`; ein gesperrtes Gesicht wird separat als `list_entry`-Treffer gemeldet.	`false`
`is_allowlisted`	Boolean	Nein	Ob das gefundene Gesicht in einer Ihrer Zulassungslisten steht.	`false`
`api_service`	string (Enum)	Ja	Großgeschriebener Typ der eigenständigen API der zugeordneten Sitzung (z. B. `PASSIVE_LIVENESS`, `FACE_MATCH`); `null` bei Workflow-Sitzungen und Treffern ohne Sitzung.	`null`

{
  "request_id": "4a1c2c4e-8b1b-4d6a-91b5-ee9a1f3a2c7f",
  "face_search": {
    "status": "Approved",
    "total_matches": 1,
    "matches": [
      {
        "session_id": "a3f2a6f1-1c1c-4eec-8b69-1c1c2f3a2c7f",
        "session_number": 1024,
        "similarity_percentage": 96.42,
        "source": "session",
        "vendor_data": "user-12345",
        "verification_date": "2024-11-04T09:14:02Z",
        "user_details": {
          "full_name": "María García López",
          "document_type": "Passport",
          "document_number": "AB1234567"
        },
        "match_image_url": "https://<media-host>/.../matched.jpg?signature=...",
        "status": "Approved",
        "is_blocklisted": false,
        "is_allowlisted": false,
        "api_service": null
      }
    ],
    "user_image": {
      "entities": [
        {
          "bbox": [40, 40, 120, 120],
          "confidence": 0.732973
        }
      ],
      "best_angle": 0
    },
    "warnings": []
  },
  "vendor_data": null,
  "metadata": null,
  "created_at": "2026-06-12T01:04:42.763237+00:00"
}

AML-Screening

Wird pro geprüfter Entität zurückgegeben. Erscheint als aml_screenings[] in GET /v3/session/{sessionId}/decision/ sowohl für KYC- als auch für KYB-Sitzungen. Quelle: aml/serializers/aml.py:63-85 (AMLV3Serializer, erweitert AMLV2Serializer in aml/serializers/aml.py:28-60).

Feld	Typ	Nullwert möglich	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`total_hits`	Ganzzahl	Nein	Anzahl der Screening-Treffer (immer vorhanden, Standardwert `0`).	`2`
`entity_type`	string (Enum)	Ja	`person` oder `company` (`EntityTypeChoices`, `common/config/choices.py:675-677`).	`"person"`
`hits`	Array aus Objekten	Nein	Ein Eintrag pro Treffer. Wichtige Felder: `id`, `caption`, `match` (bool), `target` (bool \| null: ob die Entität das direkte Ziel des Eintrags ist), `match_score` (float 0–100, Übereinstimmungswert), `risk_score` (float 0–100, Risiko-Score der Entität), `score` (veraltet, Float 0–1), `datasets[]` (z. B. `PEP`, `PEP Level 1`–`4`, `Sanctions`, `Adverse Media`, `Warnings and Regulatory Enforcement`, `Fitness and Probity`), `properties` (Namen, Aliasse, Geburtsdaten usw.), `features`, `url`, `first_seen`, `last_seen`, `rca_name`, `risk_view`, `score_breakdown`, `pep_matches`, `sanction_matches`, `warning_matches`, `adverse_media_matches`, `adverse_media_details`, `linked_entities`, `additional_information` und `review_status` (`Unreviewed`, `Confirmed Match`, `False Positive`, `Inconclusive`; bearbeitbar über den Endpoint zum Aktualisieren des AML-Trefferstatus, `AMLHitStatusChoices`).	`[…]`
`score`	float (0-100)	Ja	Gesamt-Screening-Score: der höchste `risk_score` unter den Treffern, die nicht als `False Positive` markiert sind (`aml/services/aml.py:832-842`); `0`, wenn jeder Treffer ein falsch positiver Treffer ist. `null`, bis er berechnet ist.	`42.7`
`screened_data`	object	Ja	Momentaufnahme der an das Screening gesendeten Daten: `full_name`, `nationality`, `date_of_birth`, `document_number`.	`{ "full_name": "María García López", "date_of_birth": "1990-05-12" }`
`is_ongoing_monitoring_enabled`	boolean	Nein	Gibt an, ob die Entität für erneute Screenings im Rahmen der laufenden Überwachung angemeldet ist.	`false`
`next_ongoing_monitoring_bill_date`	string (YYYY-MM-DD)	Ja	Berechnet als `last_aml_bill_date + 365 days`, wenn die laufende Überwachung aktiviert ist. Ein Abrechnungsdatum, kein Screening-Datum.	`null`
`last_ongoing_screening_at`	string (ISO 8601)	Ja	Zeitpunkt, zu dem die laufende Überwachung zuletzt eine erneute Prüfung dieses Datensatzes abgeschlossen hat, unabhängig davon, ob sich das Ergebnis geändert hat. `null`, wenn nie erneut geprüft wurde; wird niemals nachträglich ausgefüllt.	`"2026-09-12T04:03:11Z"`
`last_ongoing_screening_datasets_updated_at`	string (ISO 8601)	Ja	Letzte AML-Datensatzaktualisierung, die der Anbieter für dieses Screening gemeldet hat. `null`, wenn kein Datensatzdatum gemeldet wurde; wird niemals geschätzt.	`null`
`node_id`	string \| null	Ja	Kennung des Workflow-Knotens (V3).	`"first_aml"`
`warnings`	array	Nein	Siehe Warnungsobjekt.	`[]`

{
  "status": "In Review",
  "total_hits": 1,
  "entity_type": "person",
  "hits": [
    {
      "id": "Q7XW3-aml-hit-1",
      "caption": "Maria Garcia Lopez",
      "match": true,
      "target": true,
      "match_score": 86.4,
      "risk_score": 42.7,
      "datasets": ["PEP Level 2"],
      "properties": {
        "name": ["María García López", "M. García"],
        "alias": ["Maria Garcia"],
        "birthDate": ["1990-05-12"]
      },
      "url": "https://example.org/registry/entities/Q7XW3",
      "first_seen": "2023-11-02T00:00:00Z",
      "last_seen": "2026-05-01T00:00:00Z",
      "review_status": "Unreviewed"
    }
  ],
  "score": 42.7,
  "screened_data": {
    "full_name": "María García López",
    "date_of_birth": "1990-05-12",
    "nationality": "ES",
    "document_number": "AB1234567"
  },
  "is_ongoing_monitoring_enabled": false,
  "next_ongoing_monitoring_bill_date": null,
  "last_ongoing_screening_at": null,
  "last_ongoing_screening_datasets_updated_at": null,
  "node_id": "first_aml",
  "warnings": []
}

IP-Analyse

Wird pro erfasstem Netzwerkstandort zurückgegeben. Erscheint als ip_analyses[] in GET /v3/session/{sessionId}/decision/ für KYC- und KYB-Sitzungen. Quelle: kyc/serializers/location.py:196-243 (IPAnalysisSerializerV3).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`node_id`	string \| null	Ja	Kennung des Workflow-Knotens (V3).	`"first_ip_analysis"`
`device_brand`	string	Ja	Aus dem User-Agent abgeleitete Gerätemarke.	`"Apple"`
`device_model`	string	Ja	Gerätemodell.	`"iPhone"`
`browser_family`	string	Ja	Browserfamilie.	`"Mobile Safari"`
`os_family`	string	Ja	Betriebssystemfamilie.	`"iOS"`
`platform`	string	Ja	Übergeordnete Plattform (`mobile`, `desktop`, `tablet`).	`"mobile"`
`device_fingerprint`	string	Ja	Stabiler, gerätespezifischer Fingerprint-Hash.	`"f2a3…"`
`ip_country`	string	Ja	Aus der Adresse ermittelter Ländername.	`"Spain"`
`ip_country_code`	string (ISO 3166-1 alpha-2)	Ja	Aus der Adresse ermittelter Ländercode.	`"ES"`
`ip_state`	string	Ja	Aus der Adresse ermittelte Region / Bundesstaat.	`"Comunidad de Madrid"`
`ip_city`	string	Ja	Aus der Adresse ermittelte Stadt.	`"Madrid"`
`latitude`	float	Ja	Aus der Adresse abgeleiteter Breitengrad.	`40.4168`
`longitude`	float	Ja	Aus der Adresse abgeleiteter Längengrad.	`-3.7038`
`ip_address`	string	Ja	Die erfasste Adresse.	`"203.0.113.42"`
`isp`	string	Ja	Name des ISP.	`"Telefonica de Espana"`
`organization`	string	Ja	Name der Organisation (häufig identisch mit dem ISP).	`"Telefonica de Espana"`
`is_vpn_or_tor`	boolean	Ja	`true`, wenn die Adresse zu einem VPN, Proxy oder Tor-Exit-Knoten gehört.	`false`
`is_data_center`	boolean	Ja	`true`, wenn die Adresse zu einer bekannten Hosting- bzw. Rechenzentrums-ASN gehört.	`false`
`time_zone`	string	Ja	IANA-Zeitzonenname.	`"Europe/Madrid"`
`time_zone_offset`	string	Ja	UTC-Offset.	`"+02:00"`
`ip`	object	Nein	`{ location, distance_from_id_document, distance_from_poa_document }`. `location = { latitude, longitude }`. Entfernungen in km, `null`, wenn eine der beiden Seiten fehlt.	`{ "location": { "latitude": 40.4168, "longitude": -3.7038 }, "distance_from_id_document": 3.4, "distance_from_poa_document": 1.1 }`
`id_document`	object	Nein	`{ location, distance_from_ip, distance_from_poa_document }`. Aus `issuing_state` und der ausgelesenen Adresse ermittelter Standort des Ausweisdokuments.	`{ "location": { "latitude": 40.4165, "longitude": -3.7026 }, "distance_from_ip": 3.4, "distance_from_poa_document": 4.0 }`
`poa_document`	object	Nein	`{ location, distance_from_ip, distance_from_id_document }`. Geocodierte POA-Adresse.	`{ "location": { "latitude": 40.4170, "longitude": -3.7040 }, "distance_from_ip": 1.1, "distance_from_id_document": 4.0 }`
`matches`	array of objects	Nein	Sitzungsübergreifende Adress- und Gerätetreffer. Jeder Eintrag: `{ session_id, session_number, vendor_data, verification_date, match_type, match_source, matched_value, status, is_blocklisted, api_service, source, device_info, location_info, confidence, match_mode }`. `match_type` ist `ip_address` oder `device_fingerprint`; `match_source` ist `ip_address`, `persistent_id`, `legacy_fp` oder `recovered_high` (wiederhergestellte Treffer enthalten außerdem `recovery_similarity`, `tls_ja4_corroborated`, `recovery_gate_reason`). Auf maximal 5 Adress- und 5 Gerätetreffer begrenzt.	`[]`
`warnings`	array	Nein	Siehe Warnungsobjekt.	`[]`
`browser_version`, `os_version`	string	Ja	Browser- und Betriebssystemversionen aus dem User-Agent.	`"17.4"`
`user_agent`, `accept_language`	string	Ja	Der User-Agent-String und der `Accept-Language`-Header, die der Browser gesendet hat.	`"en-US,en;q=0.9"`
`session_identifier`, `session_age_ms`	string, integer	Ja	Die Browsing-Sitzung, in der der Schritt ausgeführt wurde, und deren Alter in Millisekunden.	`48210`
`coords_accuracy`	float	Ja	Genauigkeitsradius in Metern der vom Gerät gemeldeten Koordinaten.	`35.0`
`raw_device_data`	object	Ja	Rohe Gerätesignale, die für den Schritt erfasst wurden.	`{}`

{
  "status": "Approved",
  "node_id": "first_ip_analysis",
  "device_brand": "Apple",
  "device_model": "iPhone",
  "browser_family": "Mobile Safari",
  "os_family": "iOS",
  "platform": "mobile",
  "device_fingerprint": "f2a3c1de8b994a3f9e4cdf3a02b1a7c9",
  "ip_country": "Spain",
  "ip_country_code": "ES",
  "ip_state": "Comunidad de Madrid",
  "ip_city": "Madrid",
  "latitude": 40.4168,
  "longitude": -3.7038,
  "ip_address": "203.0.113.42",
  "isp": "Telefonica de Espana",
  "organization": "Telefonica de Espana",
  "is_vpn_or_tor": false,
  "is_data_center": false,
  "time_zone": "Europe/Madrid",
  "time_zone_offset": "+02:00",
  "ip": {
    "location": { "latitude": 40.4168, "longitude": -3.7038 },
    "distance_from_id_document": 3.4,
    "distance_from_poa_document": 1.1
  },
  "id_document": {
    "location": { "latitude": 40.4165, "longitude": -3.7026 },
    "distance_from_ip": 3.4,
    "distance_from_poa_document": 4.0
  },
  "poa_document": {
    "location": { "latitude": 40.4170, "longitude": -3.7040 },
    "distance_from_ip": 1.1,
    "distance_from_id_document": 4.0
  },
  "matches": [],
  "warnings": []
}

Standortverifizierung

Wird pro Standortverifizierungs-Schritt zurückgegeben. Erscheint als geolocation_checks[] in GET /v3/session/{sessionId}/decision/: ein Eintrag pro Schritt, und zwar dessen akzeptierter Versuch. geolocation_attempts[] listet jeden Versuch jedes Schritts auf, wobei der älteste zuerst kommt. Beide sind null bei einem Workflow ohne diesen Schritt. Quelle: GeolocationDecisionSerializer.

Feld	Typ	Nullable	Beschreibung	Beispiel
`node_id`	string	Ja	Workflow-Knoten, der das Ergebnis erzeugt hat.	`"geolocation_1"`
`status`	string	Nein	Siehe Status-Aufzählung.	`"Declined"`
`outcome`	string	Ja	Was beim Versuch passiert ist: `verified`, `low_accuracy`, `accuracy_undetermined`, `stale`, `approximate`, `denied`, `restricted`, `unavailable`, `timeout`, `mock_detected`, `outside_geofence`, `in_blocked_area`, `anonymizer_detected`, `skipped`, `replay_rejected` oder `unsupported_client`.	`"outside_geofence"`
`permission`	string	Ja	Was das System gewährt hat: `granted_precise`, `granted_approximate`, `denied`, `restricted`, `unavailable`, `timeout`, `dismissed` oder `not_requested`.	`"granted_precise"`
`latitude`, `longitude`	float	Ja	WGS84-Position. `null`, wenn keine Position vorliegt.	`48.8566`
`accuracy_m`	float	Ja	Unsicherheitsradius in Metern.	`35.0`
`accuracy_confidence`	string	Ja	`p95`, `p68` oder `unspecified`.	`"p95"`
`measured_at`, `age_seconds`	datetime, integer	Ja	Wann das Gerät die Standortbestimmung vorgenommen hat, und die Sekunden, bis Didit sie empfangen hat.	`2`
`source`, `platform`, `sdk_version`	string	Ja	Woher die Standortbestimmung stammt, der Client, der sie erzeugt hat, und dessen SDK-Version.	`"browser"`
`is_mock`, `produced_by_accessory`	boolean	Ja	Von der Plattform gemeldete Hinweise auf Spoofing. `null` bedeutet, dass die Plattform sie nicht meldet.	`null`
`integrity`	string	Nein	`attested`, `not_attested`, `failed`, `unsupported` (Web) oder `not_determined`.	`"unsupported"`
`country_code`, `region_code`, `city`	string	Ja	Der Ort, dem die Standortbestimmung zugeordnet wird.	`"FR"`
`geofence`, `inside_geofence`, `geofence_basis`, `inside_areas`, `blocked_areas`	object, boolean, string, arrays	Ja	Das Ergebnis für Land und Gebiet.	`{ "enabled": true, "result": "outside" }`
`position_source`, `anonymizers`	string, object	Ja	Woher der Schritt die Position bezieht, sowie die Signale für VPN, Proxy, Tor, Spoofing und Emulator.	`"device_and_ip"`
`ip_distance_km`, `ip_distance_uncertainty_km`, `ip_consistent`, `document_distance_km`, `travel_excused`, `consecutive_mismatches`	number, boolean, integer	Ja	Die Vergleiche mit dem IP-Standort und der hinterlegten Adresse.	`12.4`
`attempts`	integer	Nein	Die Nummer des Versuchs innerhalb des Schritts.	`3`
`consent`	object	Ja	`accepted_at`, `version` und `locale` des Hinweises, den die Person akzeptiert hat.
`warnings`	Array von Warnungsobjekten	Nein	Die `LOCATION_*`-Warnungen des Schritts. Nicht vorhanden in `geolocation_attempts[]`, das `received_at` und `created_at` ergänzt.	`[]`

Jedes Feld und jedes Beispiel finden Sie im Bericht zur Standortverifizierung.

Adressnachweis

Wird pro eingereichtem Adressdokument zurückgegeben. Erscheint als poa_verifications[] in GET /v3/session/{sessionId}/decision/. Quelle: poa/serializers/poa.py:212-227 (POAV3Serializer, erweitert POAV2Serializer in poa/serializers/poa.py:173-209).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Aufzählung.	`"Approved"`
`issuing_state`	string (ISO 3166-1 alpha-3)	Ja	Ländercode des Dokumentausstellers.	`"ESP"`
`document_type`	string	Nein	Übergeordneter Typ aus `PoaDocumentTypeChoices` (`common/config/choices.py:868-873`): `UTILITY_BILL`, `BANK_STATEMENT`, `GOVERNMENT_ISSUED_DOCUMENT`, `OTHER_POA_DOCUMENT`. Fällt auf `UNKNOWN` zurück, niemals auf `null`.	`"UTILITY_BILL"`
`document_subtype`	string	Nein	Subtyp-Code aus `PoaDocumentSubtypeChoices` (z. B. `ELECTRICITY_BILL`, `WATER_BILL`, `ACCOUNT_STATEMENT`). Fällt auf `UNKNOWN` zurück, niemals auf `null`.	`"ELECTRICITY_BILL"`
`issuer`	string	Ja	Name der ausstellenden Stelle.	`"Iberdrola"`
`issue_date`	string (YYYY-MM-DD)	Ja	Ausstellungsdatum des Dokuments.	`"2026-04-15"`
`expiration_date`	string (YYYY-MM-DD)	Ja	Auf dem Dokument aufgedrucktes Ablaufdatum, sofern vorhanden.	`null`
`poa_address`	string	Ja	Rohadresse, die per OCR extrahiert wurde.	`"Calle Mayor 1, 28001 Madrid"`
`poa_formatted_address`	string	Ja	Geocodierte bzw. formatierte Adresse.	`"Calle Mayor 1, 28001 Madrid, Spain"`
`poa_parsed_address`	object	Ja	Strukturierte Adresse (`street_1`, `street_2`, `city`, `region`, `postal_code`, `country` (alpha-2), `address_type`, `document_location`, …).	`{ "street_1": "Calle Mayor 1", "city": "Madrid", "postal_code": "28001" }`
`document_file`	string (URL)	Ja	Vorsignierte URL zum hochgeladenen Dokument.	`"https://<media-host>/.../poa.pdf?..."`
`document_language`	string	Ja	Erkannte Dokumentsprache (ISO 639-1).	`"es"`
`document_metadata`	object	Ja	Gefilterte Metadaten: `file_size`, `content_type`, `creation_date`, `modified_date`, `creator`, `producer`, `software`, `encryption`, `is_signed`, `is_tampered`, `signature_info`, `exif_original_date`, `exif_digitized_date`, `processed_by_known_editor`, `has_different_creation_mod_date`, `overlay_manipulation`.	`{ "file_size": 184221, "content_type": "application/pdf", "is_tampered": false }`
`extra_fields`	object	Nein	Bankkontofelder (`bank_account_number`, `bank_iban`, `bank_sort_code`, `bank_routing_number`, `bank_swift_bic`, `bank_branch_name`, `bank_branch_address`), `document_phone_number`, `additional_names` sowie alle benutzerdefinierten Schlüssel, die im Datensatz gespeichert sind.	`{ "bank_iban": null, "additional_names": [] }`
`name_on_document`	string	Ja	Name, wie er auf dem Adressnachweis erscheint.	`"María García López"`
`expected_details_address`	string	Ja	Adresse, die der Kunde bei der Registrierung eingegeben hat (wörtlich).	`"Calle Mayor 1, Madrid"`
`expected_details_formatted_address`	string	Ja	Geocodierte erwartete Adresse.	`"Calle Mayor 1, 28001 Madrid, Spain"`
`expected_details_parsed_address`	object	Ja	Strukturierte erwartete Adresse.	`{ "city": "Madrid", "postal_code": "28001" }`
`name_match_score_expected_details`	float (0-100)	Ja	Unscharfer Abgleich zwischen `name_on_document` und dem Namen, der beim Erstellen der Sitzung angegeben wurde.	`94.0`
`name_match_score_id_verification`	float (0-100)	Ja	Unscharfer Abgleich zwischen `name_on_document` und dem `full_name` des verifizierten Ausweises.	`100.0`
`extra_files`	Array aus Strings (URL)	Nein	Vorsignierte URLs zu zusätzlich hochgeladenen Dateien.	`[]`
`detected_codes`	Array aus Objekten	Nein	QR-Codes und Barcodes, die auf allen verarbeiteten Seiten des Dokuments erkannt wurden: `type`, `page_number` (1-basiert), `position` (Polygon), `x`/`y`/`width`/`height` (Begrenzungsrahmen), `page_width`/`page_height`, `raw_payload` (Base64), `parsed_payload` (dekodierter Wert, `null`, wenn ein Code gefunden, aber nicht dekodiert werden konnte). Leeres Array, wenn die Erkennung nichts findet.	`[{ "type": "QR_CODE", "page_number": 1, "parsed_payload": "https://issuer.example/inv/9981" }]`
`node_id`	string \| null	Ja	Workflow-Knoten-Identifikator (V3).	`"first_poa"`
`warnings`	Array	Nein	Siehe Warnungsobjekt.	`[]`

{
  "status": "Approved",
  "issuing_state": "ESP",
  "document_type": "UTILITY_BILL",
  "document_subtype": "ELECTRICITY_BILL",
  "issuer": "Iberdrola",
  "issue_date": "2026-04-15",
  "expiration_date": null,
  "poa_address": "Calle Mayor 1, 28001 Madrid",
  "poa_formatted_address": "Calle Mayor 1, 28001 Madrid, Spain",
  "poa_parsed_address": { "street_1": "Calle Mayor 1", "city": "Madrid", "postal_code": "28001", "country": "ES" },
  "document_file": "https://<media-host>/.../poa.pdf?signature=...",
  "document_language": "es",
  "document_metadata": {
    "file_size": 184221,
    "content_type": "application/pdf",
    "creation_date": "2026-04-15T08:11:32Z",
    "modified_date": "2026-04-15T08:11:32Z",
    "creator": "Iberdrola Billing",
    "producer": "Adobe PDF Library 15.0",
    "software": null,
    "encryption": null,
    "is_signed": true,
    "is_tampered": false,
    "signature_info": { "signer_name": "Iberdrola Clientes", "date": "2026-04-15T08:11:32Z" },
    "exif_original_date": null,
    "exif_digitized_date": null,
    "processed_by_known_editor": false,
    "has_different_creation_mod_date": false,
    "overlay_manipulation": null
  },
  "extra_fields": {
    "bank_account_number": null,
    "bank_iban": null,
    "bank_sort_code": null,
    "bank_routing_number": null,
    "bank_swift_bic": null,
    "bank_branch_name": null,
    "bank_branch_address": null,
    "document_phone_number": null,
    "additional_names": []
  },
  "name_on_document": "María García López",
  "expected_details_address": "Calle Mayor 1, Madrid",
  "expected_details_formatted_address": "Calle Mayor 1, 28001 Madrid, Spain",
  "expected_details_parsed_address": { "city": "Madrid", "postal_code": "28001", "country": "ES" },
  "name_match_score_expected_details": 94.0,
  "name_match_score_id_verification": 100.0,
  "extra_files": [],
  "detected_codes": [
    {
      "type": "QR_CODE",
      "page_number": 1,
      "position": [[820, 1120], [1002, 1120], [1002, 1302], [820, 1302]],
      "x": 820,
      "y": 1120,
      "width": 182,
      "height": 182,
      "page_width": 1190,
      "page_height": 1684,
      "raw_payload": "aHR0cHM6Ly9pYmVyZHJvbGEuZXMvZmFjdHVyYS85OTgx",
      "parsed_payload": "https://iberdrola.es/factura/9981"
    },
    {
      "type": "CODE_128",
      "page_number": 1,
      "position": [[112, 1480], [560, 1480], [560, 1540], [112, 1540]],
      "x": 112,
      "y": 1480,
      "width": 448,
      "height": 60,
      "page_width": 1190,
      "page_height": 1684,
      "raw_payload": "MDA5OTgxMDAwNDI=",
      "parsed_payload": "0099810042"
    }
  ],
  "node_id": "first_poa",
  "warnings": []
}

Telefonverifizierung

Wird pro Telefonverifizierungsversuch zurückgegeben. Erscheint als phone_verifications[] in GET /v3/session/{sessionId}/decision/ für KYC- und KYB-Sitzungen. Quelle: phone/serializers/phone.py:251-266 (PhoneV3Serializer, erweitert PhoneV2Serializer in phone/serializers/phone.py:103-248).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`phone_number_prefix`	string	Nein	Ländervorwahl im E.164-Format (mit `+`).	`"+34"`
`phone_number`	string	Nein	Teilnehmernummer ohne Vorwahl.	`"612345678"`
`full_number`	string	Nein	Die vollständige Nummer im E.164-Format (`phone_number_prefix + phone_number`).	`"+34612345678"`
`country_code`	string (ISO 3166-1 alpha-2)	Ja	Land der Nummer.	`"ES"`
`country_name`	string	Ja	Lokalisierter Ländername.	`"Spain"`
`carrier`	Objekt	Nein	`{ name, type }`, wobei `type` ein Wert von `LineTypeChoices` ist (`common/config/choices.py:648-667`): `mobile`, `fixed_line`, `voip`, `isp`, `vpn`, `toll_free`, `premium_rate`, `satellite`, `pager`, `payphone`, `voice_mail`, `unknown` sowie weitere Leitungsklassen.	`{ "name": "Movistar", "type": "mobile" }`
`is_disposable`	boolean	Nein	`true`, wenn der Anbieter die Nummer als temporäre bzw. Wegwerfnummer kennzeichnet.	`false`
`is_virtual`	boolean	Nein	`true`, wenn `carrier.type` einer der Werte `voip`, `isp` oder `vpn` ist.	`false`
`verification_method`	string	Nein	Kanal, über den der OTP zugestellt wurde (`whatsapp`, `sms`, …). Wird aus `actual_channel` des letzten Sendeversuchs gelesen (fällt auf den angeforderten `channel` zurück, danach auf `sms`).	`"whatsapp"`
`verification_attempts`	integer	Nein	Gesamtzahl der OTP-Sendeversuche (erster Versand plus erneutes Senden).	`1`
`verified_at`	string (ISO 8601)	Ja	Zeitstempel, zu dem der OTP erfolgreich eingegeben wurde.	`"2026-05-17T10:14:02Z"`
`lifecycle`	Array aus Objekten	Nein	Chronologische Ereignisse: Sendeversuche, Zustellungs-Callbacks, Codeprüfungen und das abschließende Statusereignis. Jedes Ereignis ist `{ type, timestamp, details, fee }`. Ereignistypen stammen aus `PhoneEventChoices`.	`[…]`
`matches`	Array aus Objekten	Nein	Sitzungsübergreifende Übereinstimmungen von Telefonnummern. Jedes Element: `{ session_id, session_number, vendor_data, verification_date, phone_number, status, is_blocklisted, api_service, source }`. `source` ist `session` oder `list_entry`.	`[]`
`node_id`	string \| null	Ja	Workflow-Knoten-Identifikator (V3).	`"first_phone"`
`warnings`	Array	Nein	Siehe Warnungsobjekt.	`[]`
`phone_intelligence`	Objekt	Ja	Signale der Telefonanalyse. Nur vorhanden, wenn das Analyse-Zusatzmodul für die Nummer ausgeführt wurde.
`phone_social`	Objekt	Ja	Soziale Präsenz der Nummer. Nur vorhanden, wenn das Zusatzmodul zur Analyse der sozialen Präsenz ausgeführt wurde.

{
  "status": "Approved",
  "phone_number_prefix": "+34",
  "phone_number": "612345678",
  "full_number": "+34612345678",
  "country_code": "ES",
  "country_name": "Spain",
  "carrier": { "name": "Movistar", "type": "mobile" },
  "is_disposable": false,
  "is_virtual": false,
  "verification_method": "whatsapp",
  "verification_attempts": 1,
  "verified_at": "2026-05-17T10:14:02Z",
  "lifecycle": [
    {
      "type": "PHONE_VERIFICATION_MESSAGE_SENT",
      "timestamp": "2026-05-17T10:13:51Z",
      "details": { "status": "Success", "reason": null, "channel": "whatsapp", "actual_channel": "whatsapp" },
      "fee": 0.02
    },
    {
      "type": "PHONE_DELIVERY_DELIVERED",
      "timestamp": "2026-05-17T10:13:52Z",
      "details": { "channel": "whatsapp", "status": "delivered" },
      "fee": 0
    },
    {
      "type": "VALID_CODE_ENTERED",
      "timestamp": "2026-05-17T10:14:02Z",
      "details": { "code_tried": "482917", "status": "Approved" },
      "fee": 0
    },
    {
      "type": "PHONE_VERIFICATION_APPROVED",
      "timestamp": "2026-05-17T10:14:02Z",
      "details": null,
      "fee": 0
    }
  ],
  "matches": [],
  "node_id": "first_phone",
  "warnings": []
}

E-Mail-Verifizierung

Wird pro E-Mail-Verifizierungsversuch zurückgegeben. Erscheint als email_verifications[] in GET /v3/session/{sessionId}/decision/ für KYC- und KYB-Sitzungen. Quelle: email_verification/serializers/email.py:149-164 (EmailV3Serializer, erweitert EmailV2Serializer in email_verification/serializers/email.py:38-146).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`email`	string	Nein	Die übermittelte E-Mail-Adresse.	`"maria.garcia@example.com"`
`is_breached`	boolean	Nein	`true`, wenn die E-Mail-Adresse in einem bekannten Datenleck auftaucht.	`false`
`breaches`	Array aus Objekten	Nein	Details zu jedem Datenleck, wenn `is_breached` `true` ist: `{ name, domain, logo_path, breach_date, description, is_verified, data_classes, breach_emails_count }`.	`[]`
`is_disposable`	boolean	Nein	`true`, wenn die E-Mail-Adresse zu einem Anbieter für Wegwerf-E-Mails gehört.	`false`
`is_undeliverable`	boolean	Nein	`true`, wenn die SMTP-Zustellprüfung ergibt, dass das Postfach keine E-Mails annimmt.	`false`
`verification_attempts`	integer	Nein	Gesamtzahl der OTP-Prüfversuche.	`1`
`verified_at`	string (ISO 8601)	Ja	Zeitstempel, zu dem der OTP erfolgreich eingegeben wurde.	`"2026-05-17T10:15:22Z"`
`lifecycle`	Array aus Objekten	Nein	Chronologische Ereignisse: Sendeversuche, Codeprüfungen und das abschließende Statusereignis. Jedes Ereignis ist `{ type, timestamp, details, fee }`. Ereignistypen stammen aus `EmailEventChoices`.	`[…]`
`matches`	Array aus Objekten	Nein	Sitzungsübergreifende E-Mail-Übereinstimmungen. Jedes Element: `{ session_id, session_number, vendor_data, verification_date, email, status, is_blocklisted, api_service, source }`. `source` ist `session` oder `list_entry`.	`[]`
`node_id`	string \| null	Ja	Workflow-Knoten-Identifikator (V3).	`"first_email"`
`warnings`	Array	Nein	Siehe Warnungsobjekt.	`[]`
`email_intelligence`	Objekt	Ja	Signale der E-Mail-Analyse. Nur vorhanden, wenn das Analyse-Zusatzmodul für die Adresse ausgeführt wurde.
`email_social`	Objekt	Ja	Soziale Präsenz der Adresse. Nur vorhanden, wenn das Zusatzmodul zur Analyse der sozialen Präsenz ausgeführt wurde.

{
  "status": "Approved",
  "email": "maria.garcia@example.com",
  "is_breached": false,
  "breaches": [],
  "is_disposable": false,
  "is_undeliverable": false,
  "verification_attempts": 1,
  "verified_at": "2026-05-17T10:15:22Z",
  "lifecycle": [
    {
      "type": "EMAIL_VERIFICATION_MESSAGE_SENT",
      "timestamp": "2026-05-17T10:15:11Z",
      "details": { "status": "Success", "reason": null },
      "fee": 0.02
    },
    {
      "type": "VALID_CODE_ENTERED",
      "timestamp": "2026-05-17T10:15:22Z",
      "details": { "code_tried": "739204", "status": "Approved" },
      "fee": 0
    },
    {
      "type": "EMAIL_VERIFICATION_APPROVED",
      "timestamp": "2026-05-17T10:15:22Z",
      "details": null,
      "fee": 0
    }
  ],
  "matches": [],
  "node_id": "first_email",
  "warnings": []
}

Datenbankvalidierung

Wird pro Datenbankabfrage zurückgegeben, die mit den vom Benutzer übermittelten Daten ausgeführt wurde. Erscheint als database_validations[] in GET /v3/session/{sessionId}/decision/. Quelle: database_validation/serializers/database_validation.py:21-142 (DatabaseValidationV3Serializer, erweitert DatabaseValidationV2Serializer).

Feld	Typ	Nullable	Beschreibung	Beispiel
`issuing_state`	string (ISO 3166-1 alpha-3)	Ja	Land, dessen Register abgefragt wurde.	`"ESP"`
`validation_type`	string (Enum)	Nein	Wie das Ergebnis bestätigt wurde: `one_by_one` (Ergebnis eines einzelnen Dienstes), `two_by_two` (zwei oder mehr unterschiedliche Dienste haben die Identifikationsnummer unabhängig voll abgeglichen) oder `not_enabled` (der Validator wurde übersprungen oder kein Anbieter hat geantwortet; ein eindeutiges `no_match` ergibt trotzdem `one_by_one`). Niemals `null`. Quelle: `DatabaseValidationChoices` (`common/config/choices.py:1097-1100`).	`"one_by_one"`
`screened_data`	Objekt	Nein	Die an das Register übermittelten Daten. Dateifelder (`selfie`, `cnh_qr_code_image`, `document_image`) werden zum Zeitpunkt des Lesens als presigned URL bereitgestellt.	`{ "document_number": "99999999R", "date_of_birth": "1990-05-12" }`
`validations`	Array aus Objekten	Nein	Ein Eintrag pro Katalogdienst, der eine Übereinstimmung geliefert hat. Jeder Eintrag kann `service_id`, `service_name`, `validation` (Bewertungsobjekt des Anbieters), `outcome_code`, `outcome_detail` und `source_data` (bereinigtes Bürgerprofil: `full_name`, `gender`, `date_of_birth`, `photo` (presigned URL), `signature` (presigned URL), …) enthalten.	`[…]`
`errors`	Array aus Objekten	Ja	Fehler pro Dienst, wenn eine Abfrage fehlgeschlagen ist; der Schlüssel wird vollständig weggelassen, wenn er leer ist. Jeder Eintrag ist das Fehlerobjekt des vorgelagerten Dienstes zuzüglich der `service_id`, die ihn erzeugt hat.	`[]`
`match_type`	string (Enum)	Ja	Aggregiertes Übereinstimmungsergebnis über alle abgefragten Dienste: `full_match`, `partial_match` oder `no_match` (`DatabaseValidationMatchTypeChoices`, `common/config/choices.py:1103-1106`). `null`, bis es ausgewertet wurde.	`"full_match"`
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`node_id`	string \| null	Ja	Workflow-Knotenkennung (V3).	`"first_db_validation"`
`warnings`	Array	Nein	Siehe Warnungsobjekt.	`[]`

{
  "issuing_state": "ESP",
  "validation_type": "one_by_one",
  "screened_data": {
    "document_number": "99999999R",
    "date_of_birth": "1990-05-12",
    "first_name": "María",
    "last_name": "García López"
  },
  "validations": [
    {
      "service_id": "esp_dni",
      "service_name": "Spain - DNI/NIE verification",
      "validation": { "is_valid": true, "match_score": 100 },
      "outcome_code": "MATCH",
      "outcome_detail": "All identifiers match the registry record.",
      "source_data": {
        "full_name": "María García López",
        "gender": "F",
        "date_of_birth": "1990-05-12",
        "photo": "https://<media-host>/.../registry_photo.jpg?signature=...",
        "signature": null
      }
    }
  ],
  "match_type": "full_match",
  "status": "Approved",
  "node_id": "first_db_validation",
  "warnings": []
}

Fragebogen-Antwort

Wird pro Fragebogen-Übermittlung zurückgegeben. Erscheint als questionnaire_responses[] in GET /v3/session/{sessionId}/decision/ für KYC- und KYB-Sitzungen. Quelle: questionnaires/serializers/questionnaire.py:591-597 (QuestionnaireResponseV3Serializer, erweitert QuestionnaireResponseSerializer in questionnaires/serializers/questionnaire.py:520-588).

Feld	Typ	Nullable	Beschreibung	Beispiel
`questionnaire_id`	string (UUID)	Nein	Kennung der beantworteten Fragebogenversion.	`"6a0f1c2c-…"`
`title`	string	Nein	Name des Fragebogens, wie in der Console festgelegt.	`"Customer risk profile"`
`description`	string	Ja	Beschreibung des Fragebogens.	`"Short risk-profile questions."`
`languages`	Array aus Strings	Nein	Sprachcodes, in denen der Fragebogen veröffentlicht ist.	`["en", "es"]`
`default_language`	string	Nein	Ersatz-Sprachcode.	`"en"`
`is_active`	boolean	Nein	Ob diese Fragebogenversion die aktive ist.	`true`
`is_simple_questionnaire`	boolean	Nein	`true`, wenn der Fragebogen keine Verzweigungen hat (flache Liste).	`true`
`questionnaire_group_id`	string (UUID)	Nein	Kennung, die allen Versionen desselben Fragebogens gemeinsam ist.	`"a7c2c2c2-…"`
`version`	integer	Nein	Versionsnummer der aktiven Vorlage.	`3`
`status`	string	Nein	Einer von `Approved`, `In Review`, `Not Finished` (eine Ablehnung auf Fragebogenebene wird auf `In Review` abgebildet).	`"Approved"`
`published_at`	string (ISO 8601)	Ja	Zeitpunkt, zu dem die Vorlage veröffentlicht wurde.	`"2026-01-12T11:00:00Z"`
`sections`	Array aus Objekten	Nein	Geordnete Abschnitte, nachdem Graph-Traversierung und Sichtbarkeitsfilter angewendet wurden. Jeder Abschnitt ist `{ title, description, items[] }` (title und description stammen aus dem öffnenden `SECTION_HEADER`, bereits übersetzt). Jedes Element ist ein Formularelement (`uuid`, `value` (Knoten-ID), `element_type`, `is_required`, `title`, `description`, `placeholder`, `choices`, `max_files`, `required_if`, `repeatable_config`, dazu ein Feld `answer`, das `null` ist, wenn unbeantwortet, und bei `HEADING`-, `PARAGRAPH`- und `SEPARATOR`-Layoutelementen weggelassen wird). Dateiantworten enthalten `{ files: [<presigned URL>, …] }`.	`[…]`
`node_id`	string \| null	Ja	Workflow-Knotenkennung (V3).	`"first_questionnaire"`

{
  "questionnaire_id": "6a0f1c2c-3b7d-4d2c-9eb6-fdc6c7c92ef9",
  "title": "Customer risk profile",
  "description": "Short risk-profile questions.",
  "languages": ["en", "es"],
  "default_language": "en",
  "is_active": true,
  "is_simple_questionnaire": true,
  "questionnaire_group_id": "a7c2c2c2-1111-4d2c-9eb6-fdc6c7c92ef9",
  "version": 3,
  "status": "Approved",
  "published_at": "2026-01-12T11:00:00Z",
  "sections": [
    {
      "title": "Source of funds",
      "description": null,
      "items": [
        {
          "uuid": "4f1d5e2c-aaaa-4d2c-9eb6-fdc6c7c92ef9",
          "value": "q_source_of_funds",
          "element_type": "SINGLE_CHOICE",
          "is_required": true,
          "title": "What is your main source of funds?",
          "description": null,
          "placeholder": null,
          "choices": [
            { "label": "Salary", "value": "salary" },
            { "label": "Business income", "value": "business" },
            { "label": "Investments", "value": "investments" }
          ],
          "max_files": 1,
          "required_if": null,
          "repeatable_config": null,
          "answer": { "value": "salary" }
        }
      ]
    }
  ],
  "node_id": "first_questionnaire"
}

E-Signatur

Wird pro Unterzeichner eines E-Signatur-Schritts zurückgegeben. Erscheint als signatures[] in GET /v3/session/{sessionId}/decision/ für KYC- und KYB-Sitzungen, nur wenn der Workflow den Schritt enthält. Anders als die übrigen Berichtsobjekte ist ihr status die Signierphase, und das Ergebnis steht in verdict. Die Elemente von warnings[] sind { code, node_id } statt Warnungsobjekte.

Feld	Typ	Nullable	Beschreibung	Beispiel
`id`	string (UUID)	Nein	Die Signatur des Unterzeichners. Verwenden Sie sie als `signature_id` für die Nachweis- und Validierungsrouten.	`"0e6c2a8e-…"`
`node_id`	string	Nein	Workflow-Knotenkennung.	`"feature_signature"`
`status`	string	Nein	Signierphase: `intro`, `review`, `code`, `signing`, `signed` oder `declined`. Nur `signed` bedeutet, dass die Dokumente signiert sind.	`"signed"`
`verdict`	string	Nein	`Not Finished`, `Approved`, `In Review` oder `Declined`.	`"Approved"`
`level`	string	Nein	`simple` (Standard), `aes` oder `qes` (qualifiziert, ein Zusatzmodul).	`"aes"`
`format`	string	Nein	`pdf` für eine einfache Signatur, `pades` für fortgeschrittene (AES) und qualifizierte (QES) Signaturen.	`"pades"`
`profile`	string	Ja	`PAdES-B-LT`, sobald eine fortgeschrittene (AES) oder qualifizierte (QES) Signatur unterzeichnet wurde, andernfalls null.	`"PAdES-B-LT"`
`signer`	Objekt	Nein	`{ name, capacity, company, role, roles, identity_session_id }`. `capacity` ist `self` (KYC) oder `company` (KYB).	`{ "name": "Jane Doe", "capacity": "self", … }`
`identity_used`	Objekt	Nein	`{ session_id, kyc_id, verified, expected_name }`: die verifizierte Identität, auf die sich die Signatur stützt. Bei einer einfachen Signatur ohne verifizierte Identität leer.	`{ "verified": true, … }`
`certificate`	Objekt	Ja	`{ issuer, issued_to, serial, valid_from, valid_until }`. `null`, bis die Signatur erfolgt ist, und bei einer einfachen Signatur immer `null`.	`{ "serial": "5A3F9C21", … }`
`confirmation`	Objekt	Nein	`{ channel, destination, confirmed_at, attempts }`. `destination` ist maskiert. `attempts` zählt die eingegebenen Codes, einschließlich des richtigen. Bei einer einfachen Signatur gibt es keinen Code, daher sind `channel` und `destination` `null`.	`{ "channel": "email", … }`
`timestamp`	Objekt	Ja	`{ time, qualified, valid }`. `qualified` ist bei AES immer `false`, weil Didit den Zeitstempel ausstellt. Bei QES stellt ihn der qualifizierte Vertrauensdiensteanbieter aus. `null`, bis unterzeichnet wurde, und bei einer einfachen Signatur immer `null`.	`{ "qualified": false, … }`
`documents`	Array von Objekten	Nein	`{ id, uuid, title, language, source_revision, translation_id, file_name, pages, size_bytes, sha256_original, sha256_signed, status, opened_at, read_at, read_to_end, consented_at, consent, signed_file, mode, source_format, conversion, fields }`. `status` ist `signed`, `declined`, `not_signed` oder `not_reached`. `mode` ist `fields` oder `read_and_agree`. `source_format` ist `pdf` oder `docx`. `conversion` beschreibt die ursprüngliche Word-Datei oder ist bei einer PDF `null`.	`[…]`
`documents[].language`	string	Ja	Sprache der Version, die beim Start des Versuchs ausgewählt wurde, oder `null`, wenn keine gesetzt ist. Wird eine vollständige passende Übersetzung gefunden, wird sie verwendet, andernfalls das Original. Nach der Unterzeichnung ist dies die tatsächlich unterzeichnete Sprache.	`"en"`
`documents[].source_revision`	string (UUID)	Nein	Quellrevision, die beim Versuch übernommen wurde, auch wenn eine Übersetzung ausgewählt ist. Sie unterscheidet sich von der `id` des Dokuments des Unterzeichners.	`"22222222-2222-4222-8222-222222222222"`
`documents[].translation_id`	string (UUID)	Ja	Ausgewählte Übersetzung oder `null` für das Original. Die Dokumentkopie und ihre Sprachauswahl bleiben nach dem Start des Versuchs unverändert.	`null`
`documents[].fields`	Array von Objekten	Nein	`{ key, type, role, label, page, x, y, width, height, required, value, display_value, value_source, filled_at, image_url, value_unavailable_reason }` für jedes Feld im Dokument. `value` ist ein String, bei einem Kontrollkästchen ein Boolean oder `true` bei einer angewendeten Signatur oder bei Initialen. Bei einem Dokument ohne Felder ist das Array leer.	`[…]`
`adopted_signature`	Objekt	Ja	`{ method, font, adopted_at }`: die Signatur und Initialen, die der Unterzeichner übernommen hat. `method` ist `typed` oder `drawn`. `font` ist der Handschriftstil einer getippten Signatur. `null`, bis die Signatur übernommen wurde.	`{ "method": "drawn", … }`
`electronic_signature_consent_at`	string (ISO 8601)	Ja	Zeitpunkt, zu dem der Unterzeichner zugestimmt hat, die Dokumente elektronisch zu unterzeichnen. Wird gesetzt, wenn ein Dokument Felder enthält.	`"2026-11-03T10:41:40Z"`
`evidence_file`	string	Ja	Pfad der Nachweis-PDF, sobald unterzeichnet wurde.	`"/v3/session/…/evidence/?signature_id=…"`
`warnings`	Array von Objekten	Nein	`{ code, node_id }`, wobei `code` einer der folgenden Werte ist: `SIGNATURE_DECLINED`, `SIGNATURE_OTP_FAILED`, `SIGNATURE_NAME_MISMATCH`, `SIGNATURE_IDENTITY_NOT_VERIFIED`, `SIGNATURE_DOCUMENT_CHANGED`.	`[]`
`validation`	Objekt	Ja	`{ valid, checked_at, documents[] }`: die letzte kryptografische Prüfung der unterzeichneten Dokumente. `null`, bis unterzeichnet wurde. `{ valid: null, reason: "signature_provider_outcome_unknown", checked_at }`, wenn das Ergebnis der Unterzeichnung nicht bestätigt werden konnte.	`{ "valid": true, … }`
`declined_at`	string (ISO 8601)	Ja	Zeitpunkt, zu dem der Unterzeichner abgelehnt hat.	`null`
`declined_action`	string	Nein	Die `signature_declined_action` des Schritts.	`"REVIEW"`
`signed_at`	string (ISO 8601)	Ja	Zeitpunkt, zu dem die Dokumente unterzeichnet wurden.	`"2026-11-03T10:42:24Z"`
`expires_at`	string (ISO 8601)	Nein	Zeitpunkt, ab dem der Signatur-Link nicht mehr funktioniert.	`"2026-11-10T10:30:00Z"`
`email_sent_at`	string (ISO 8601)	Ja	Zeitpunkt, zu dem dem Unterzeichner eine signierte Kopie per E-Mail gesendet wurde.	`"2026-11-03T10:42:30Z"`
`email_unavailable_reason`	string	Ja	Grund, warum keine Kopie per E-Mail gesendet wurde, wenn eine angefordert war.	`null`
`ip_address`	string	Ja	Die Adresse des Unterzeichners zum Zeitpunkt, als er seinen Code angefordert hat.	`"203.0.113.10"`
`place`	string	Ja	Wird nicht erfasst: immer `null`.	`null`
`place_unavailable_reason`	string	Ja	`not_collected`.	`"not_collected"`

Der E-Signatur-Bericht enthält ein vollständiges Beispiel und alle verschachtelten Felder.

Altersschätzung

Wird von der eigenständigen Altersschätzungs-API (POST /v3/age-estimation/) zurückgegeben. Die Antwort enthält eine Teilmenge der Struktur von Liveness check innerhalb einer age_estimation-Hülle: status, method, score, age_estimation, warnings. Hinzu kommt ein nur in der eigenständigen API vorhandener Block user_image zur Gesichtserkennung. Sie enthält nicht reference_image, video_url, matches, face_quality oder face_luminance. In Workflow-Sitzungen gibt es kein separates Array. Das geschätzte Alter erscheint als liveness_checks[].age_estimation in GET /v3/session/{sessionId}/decision/. Quelle: apis/serializers/age_estimation.py:50-55 (AgeEstimationResponseSerializer), Hülle zusammengesetzt in apis/views/age_estimation.py:138-174.

Feld	Typ	Nullable	Beschreibung	Beispiel
`request_id`	string (UUID)	Nein	Gespeicherte Sitzungs-ID, wenn `save_api_request=true` (der Standard). Andernfalls eine temporäre Korrelations-UUID.	`"3b1f1e2c-…"`
`age_estimation`	Objekt	Nein	Ergebnis-Hülle: `status` (`Approved` / `Declined`), `method` (immer `PASSIVE`), `score` (Liveness, 0-100, nullable), `age_estimation` (vorhergesagtes Alter in Jahren des größten Gesichts, nullable), `user_image` (`entities[]` mit pro Gesicht `age`, `bbox` `[x_min, y_min, x_max, y_max]`, `confidence`, `gender`, außerdem `best_angle`), `warnings[]`.	`{ … }`
`vendor_data`	string	Ja	Aus der Anfrage übernommenes `vendor_data`.	`null`
`metadata`	Objekt	Ja	Aus der Anfrage übernommenes `metadata`.	`null`
`created_at`	string (ISO 8601)	Nein	Zeitstempel der Anfrage auf dem Server.	`"2026-05-17T10:22:13.512941+00:00"`

{
  "request_id": "3b1f1e2c-7777-4d2c-9eb6-fdc6c7c92ef9",
  "age_estimation": {
    "status": "Approved",
    "method": "PASSIVE",
    "score": 94.10,
    "age_estimation": 28.7,
    "user_image": {
      "entities": [
        { "age": 28.7, "bbox": [40, 40, 100, 100], "confidence": 0.72, "gender": "male" }
      ],
      "best_angle": 0
    },
    "warnings": []
  },
  "vendor_data": null,
  "metadata": null,
  "created_at": "2026-05-17T10:22:13.512941+00:00"
}

Biometrische Authentifizierung

Die biometrische Authentifizierung führt dieselbe Pipeline für Liveness-Erkennung und Gesichtsabgleich aus, wie sie beim Standard-KYC verwendet wird. Sie ist allerdings so konfiguriert, dass das erfasste Gesicht mit einem bestehenden Referenzbild des Benutzers verglichen wird, statt mit einem frisch per OCR ausgelesenen Porträt aus dem Dokument. Es gibt keinen eigenen Serializer. GET /v3/session/{sessionId}/decision/ gibt die Standardobjekte Liveness-Prüfung und Gesichtsabgleich unter liveness_checks[] und face_matches[] zurück. Der Workflow der Sitzung ist mit workflow_type = "biometric_authentication" konfiguriert (WorkflowTypeChoices, common/config/choices.py:636).

Feld	Typ	Nullable	Beschreibung	Beispiel
`liveness_checks`	Array aus Liveness-Prüfungen	Nein	Liveness-Ergebnis für den Authentifizierungsversuch.	`[ { "status": "Approved", … } ]`
`face_matches`	Array aus Gesichtsabgleichen	Nein	Abgleichsergebnis mit der hinterlegten Referenz. `source_image_session_id` wird auf die eigene `session_id` der Sitzung gesetzt: Das Referenzgesicht (das übermittelte `portrait_image` oder das gespeicherte Gesicht, das über `vendor_data` wiederverwendet wird, wenn `portrait_image` weggelassen wird) wird unter der Authentifizierungssitzung selbst erfasst (`face/views/face.py:656-659`).	`[ { "status": "Approved", "source_image_session_id": "…", … } ]`
`status`	string	Nein	Status der Sitzung auf oberster Ebene (siehe Status-Enum).	`"Approved"`

{
  "session_id": "9b1f1e2c-8888-4d2c-9eb6-fdc6c7c92ef9",
  "status": "Approved",
  "liveness_checks": [
    {
      "status": "Approved",
      "method": "PASSIVE",
      "score": 95.10,
      "reference_image": "https://<media-host>/.../reference.jpg?signature=...",
      "video_url": null,
      "age_estimation": null,
      "matches": [],
      "face_quality": 91.20,
      "face_luminance": 53.10,
      "node_id": "biometric_auth_liveness",
      "warnings": []
    }
  ],
  "face_matches": [
    {
      "status": "Approved",
      "score": 98.42,
      "source_image_session_id": "9b1f1e2c-8888-4d2c-9eb6-fdc6c7c92ef9",
      "source_image": "https://<media-host>/.../source.jpg?signature=...",
      "target_image": "https://<media-host>/.../target.jpg?signature=...",
      "node_id": "biometric_auth_face_match",
      "warnings": []
    }
  ]
}

KYB-Register

Wird pro im Register bestätigtem Unternehmen in einem KYB-Workflow zurückgegeben. Erscheint als registry_checks[] in GET /v3/session/{sessionId}/decision/ für Unternehmenssitzungen. Quelle: kyb/serializers/kyb.py:939-964 (RegistryCheckV3Serializer).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`node_id`	string \| null	Ja	Workflow-Knotenkennung (V3).	`"first_registry"`
`data_resolved`	boolean	Nein	`true`, wenn der Registerabruf abgeschlossen ist (oder `is_from_registry` `false` ist, was bedeutet, dass die Daten manuell eingegeben wurden).	`true`
`company`	object	Nein	Vollständige Unternehmens-Payload, siehe Unternehmensobjekt unten.	`{ … }`
`ownership_structure`	object	Ja	Die Anteilsstruktur, die das Register belegt hat: `shareholders[]` und `beneficial_owners[]`, wobei jeder Eigentümer seine Registeridentität, seinen Anteil und das kanonische `shareholding` enthält.	`{ "shareholders": [...], "beneficial_owners": [] }`
`warnings`	Array	Nein	Siehe Warnungsobjekt.	`[]`

Unternehmensobjekt

Aus kyb/serializers/kyb.py:220-321 (KYBCompanyResponseSerializer).

Feld	Typ	Nullable	Beschreibung
`uuid`	string (UUID)	Nein	Interne Unternehmenskennung.
`node_id`	string \| null	Ja	Workflow-Knotenkennung.
`status`	string	Nein	Funktionsstatus (`FeatureStatusChoices`).
`registry_status`	string	Ja	Unternehmensstatus aus dem Register (`active`, `dissolved`, …).
`data_resolved`	boolean	Nein	Gleiche Definition wie beim übergeordneten Objekt.
`company_name`	string	Ja	Eingetragener Firmenname.
`registration_number`	string	Ja	Registernummer.
`country_code`	string (ISO 3166-1 alpha-2)	Ja	Gründungsland.
`region`	string	Ja	ISO-3166-2-Untereinheit, sofern zutreffend (z. B. `US-CA`).
`company_type`	string	Ja	Rechtsform (`LLC`, `SL`, …).
`incorporation_date`	string (YYYY-MM-DD)	Ja	Gründungsdatum.
`registered_address`	string	Ja	Eingetragene Rechtsadresse.
`tax_number`	string	Ja	Steuernummer bzw. USt-IdNr.
`risk_level`	string	Ja	Vom Anbieter gelieferte Risikostufe.
`verification_status`	string	Ja	Interner Enum für den Verifizierungsstatus.
`is_from_registry`	boolean	Nein	`true`, wenn die Daten aus dem Register stammen (im Gegensatz zur manuellen Eingabe).
`fetch_status`	string	Ja	`pending`, `resolved`, `failed`.
`alternative_names`	string	Ja	Kommagetrennte alternative Handelsnamen.
`nature_of_business`	string	Ja	Freitextbeschreibung der Geschäftstätigkeit.
`registered_capital`	string	Ja	Eingetragenes Kapital als lesbare Zeichenkette.
`registered_capital_amount`	string (decimal)	Ja	Analysierter Betrag des eingetragenen Kapitals.
`registered_capital_currency`	string (ISO 4217)	Ja	Währungscode.
`website`	string (URL)	Ja	Website des Unternehmens.
`email`	string	Ja	Öffentliche Kontakt-E-Mail.
`phone`	string	Ja	Öffentliche Kontakttelefonnummer.
`legal_entity_identifier`	string	Ja	LEI, sofern verfügbar.
`location_of_registration`	string	Ja	Registeramt bzw. Region.
`vat_number`	string	Ja	USt-Nummer, die für das Unternehmen übermittelt wurde.
`vat_validation_status`	string	Nein	Ergebnis der Validierung der USt-Nummer oder, falls keine vorhanden ist, der `tax_number`: `valid`, `invalid`, `format_valid`, `invalid_format`, `could_not_validate` oder `not_applicable`. Siehe USt- und Steuernummernvalidierung.
`vat_validated_number`	string	Ja	Die geprüfte Nummer, so wie die Quelle sie kennt.
`vat_validation_source`	string	Ja	Quelle, die den Status bestimmt hat: `eu_vies`, `pl_vat_white_list`, `no_brreg`, `ch_uid_register`, `br_receita_federal`, `co_rues`, `cr_hacienda`, `ec_sri`, `py_dnit` oder `format_rules`.
`vat_validated_name`	string	Ja	Beim Quellsystem registrierter Name (leer, wenn es keinen angibt).
`vat_validated_address`	string	Ja	Beim Quellsystem registrierte Adresse (leer, wenn nicht angegeben).
`vat_checked_at`	string (ISO 8601)	Ja	Zeitstempel der Prüfung; `null`, wenn keine Prüfung stattfand.
`financial_summary`	object	Ja	Momentaufnahme der neuesten Finanzkennzahlen, sofern vom Register bereitgestellt.
`officers`	Array von Objekten	Nein	B2C-sichere Liste der Organmitglieder: `{ uuid, name, designation, role, nationality, is_active, kyc_status, kyc_session_url }`.
`beneficial_owners`	Array von Objekten	Nein	B2C-sichere Liste der wirtschaftlich Berechtigten (UBO): `{ uuid, name, first_name, last_name, entity_type, roles, ownership_min_shares, ownership_max_shares, is_active, kyc_status, kyc_session_url, effective_ownership_percent }`.
`addresses`	Array von Objekten	Ja	Adressdetails pro Adresse aus dem Register.
`industries`	Array von Objekten	Ja	Klassifizierungen im Stil von SIC/NAICS.
`accounts`	Array von Objekten	Ja	Metadaten zu eingereichten Jahresabschlüssen.
`registry_data`	object	Ja	Von Didit normalisierte Registerdetails (Ergebnis der Eigentümerstruktur, Korrekturen in der Console, Registerfakten ohne eigenes Feld). Kein stabiler Vertrag.
`user_provided_data`	object	Ja	Momentaufnahme der vom Benutzer bearbeiteten Felder.
`confirmed_by_user_at`	string (ISO 8601)	Ja	Zeitstempel, zu dem der Benutzer die extrahierten Daten bestätigt hat.
`last_console_edit_at`	string (ISO 8601)	Ja	Zeitstempel der letzten Bearbeitung in der Console.
`is_editable`	boolean	Nein	`true`, solange die aus dem Register stammenden Daten vom Endbenutzer noch bearbeitet werden können.

{
  "status": "Approved",
  "node_id": "first_registry",
  "data_resolved": true,
  "company": {
    "uuid": "b1f1e2c2-9999-4d2c-9eb6-fdc6c7c92ef9",
    "node_id": "first_registry",
    "status": "Approved",
    "registry_status": "active",
    "data_resolved": true,
    "company_name": "Sante Clinics SL",
    "registration_number": "B12345678",
    "country_code": "ES",
    "region": null,
    "company_type": "SL",
    "incorporation_date": "2018-03-22",
    "registered_address": "Calle Mayor 1, 28001 Madrid, Spain",
    "tax_number": "B12345678",
    "risk_level": "low",
    "verification_status": "verified",
    "is_from_registry": true,
    "fetch_status": "resolved",
    "alternative_names": "Sante Clinics",
    "nature_of_business": "Medical clinic operations",
    "registered_capital": "EUR 50,000",
    "registered_capital_amount": "50000.00",
    "registered_capital_currency": "EUR",
    "website": "https://santeclinics.com",
    "email": "info@santeclinics.com",
    "phone": "+34911223344",
    "legal_entity_identifier": null,
    "location_of_registration": "Registro Mercantil de Madrid",
    "vat_number": "ESB12345678",
    "vat_validation_status": "valid",
    "vat_validated_name": "SANTE CLINICS SL",
    "vat_validated_address": "CALLE MAYOR 1, 28001 MADRID",
    "vat_checked_at": "2026-05-17T10:11:05Z",
    "financial_summary": null,
    "officers": [
      {
        "uuid": "c1f1e2c2-aaaa-4d2c-9eb6-fdc6c7c92ef9",
        "name": "María García López",
        "designation": "Administrador único",
        "role": "Director",
        "nationality": "ESP",
        "is_active": true,
        "kyc_status": "Approved",
        "kyc_session_url": "https://verify.didit.me/s/…"
      }
    ],
    "beneficial_owners": [
      {
        "uuid": "d1f1e2c2-bbbb-4d2c-9eb6-fdc6c7c92ef9",
        "name": "María García López",
        "first_name": "María",
        "last_name": "García López",
        "entity_type": "person",
        "roles": ["UBO"],
        "ownership_min_shares": "75.00",
        "ownership_max_shares": "75.00",
        "is_active": true,
        "kyc_status": "Approved",
        "kyc_session_url": "https://verify.didit.me/s/…",
        "effective_ownership_percent": 75.0
      }
    ],
    "addresses": [],
    "industries": [],
    "accounts": [],
    "registry_data": {},
    "user_provided_data": {},
    "confirmed_by_user_at": "2026-05-17T10:11:02Z",
    "last_console_edit_at": null,
    "is_editable": false
  },
  "ownership_structure": null,
  "warnings": []
}

KYB-Dokument

Wird pro Knoten zurückgegeben, der KYB-Nachweisdokumente erfasst. Erscheint als document_verifications[] in GET /v3/session/{sessionId}/decision/ für Unternehmenssitzungen, mit einem Eintrag pro node_id und einer Liste items[] der hochgeladenen Dokumente. Quelle: kyb/serializers/kyb.py:1053-1068 (DocumentVerificationV3Serializer); jedes Element folgt kyb/serializers/kyb.py:811-851 (KYBDocumentResponseSerializer).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Aggregierter Status über die Dokumente dieses Knotens: `Approved` nur, wenn alle Pipeline-Dokumente genehmigt sind; `Declined`, wenn eines abgelehnt ist; `In Review` in allen anderen Fällen; `Not Finished`, solange ausstehend. Siehe Status-Enum.	`"Approved"`
`node_id`	string \| null	Ja	Workflow-Knoten-Kennung (V3).	`"first_kyb_documents"`
`items`	Array aus KYB-Dokumentelement-Objekten	Nein	Ein Eintrag pro hochgeladenem oder angefordertem Dokument.	`[…]`
`groups`	object	Nein	Anzahl je Dokumentgruppe: `{ <group_name>: { total, approved, pending, declined, in_review, other, missing } }`.	`{ "incorporation_certificate": { "total": 1, "approved": 1, "pending": 0, "declined": 0, "in_review": 0, "other": 0, "missing": 0 } }`
`required_groups`	Array aus Strings	Nein	Dokumentgruppen, die die Workflow-Konfiguration verlangt.	`["incorporation_certificate", "shareholder_register"]`
`warnings`	array	Nein	Siehe Warnungsobjekt.	`[]`

KYB-Dokumentelement-Objekt

Feld	Typ	Nullable	Beschreibung
`uuid`	string (UUID)	Nein	Interne Dokumentkennung.
`document_type`	string	Ja	Übergeordnete Gruppe (`incorporation_certificate`, `shareholder_register`, …).
`document_subtype`	string	Ja	Anbieterspezifischer Untertyp.
`document_group`	string	Ja	Spiegel von `document_type` (Alias zur besseren Übersicht beibehalten).
`file_url`	string (URL)	Ja	Presigned-URL zur bereinigten Datei.
`original_filename`	string	Ja	Dateiname wie hochgeladen.
`file_size`	integer	Ja	Dateigröße in Byte.
`status`	string	Nein	Status des einzelnen Dokuments (`FeatureStatusChoices`).
`created_at`	string (ISO 8601)	Nein	Zeitstempel des Uploads.
`cross_check_result`	object	Ja	Ergebnis der Gegenprüfung gegen das Register bzw. gegen andere Dokumente.
`document_metadata`	object	Ja	Dieselbe gefilterte Metadatenstruktur wie das `document_metadata` von POA.
`description`	string	Ja	Vom Prüfer oder vom System angegebene Beschreibung.
`is_requested`	boolean	Nein	`true`, wenn der Workflow dieses Dokument erwartet hat.
`ocr_data`	object	Ja	Per OCR extrahierte Felder, sofern verfügbar.
`is_console_upload`	boolean	Nein	`true`, wenn das Dokument von einem Prüfer in der Console hochgeladen wurde (von der Gesamtbewertung ausgeschlossen).
`is_confirmed`	boolean	Nein	`true`, wenn der Prüfer das Dokument ausdrücklich bestätigt hat.

{
  "status": "Approved",
  "node_id": "first_kyb_documents",
  "items": [
    {
      "uuid": "e1f1e2c2-cccc-4d2c-9eb6-fdc6c7c92ef9",
      "document_type": "incorporation_certificate",
      "document_subtype": "registro_mercantil_extract",
      "document_group": "incorporation_certificate",
      "file_url": "https://<media-host>/.../incorporation.pdf?signature=...",
      "original_filename": "incorporation_certificate.pdf",
      "file_size": 256412,
      "status": "Approved",
      "created_at": "2026-05-17T10:08:00Z",
      "cross_check_result": { "matches_registry_name": true, "matches_registration_number": true },
      "document_metadata": {
        "file_size": 256412,
        "content_type": "application/pdf",
        "is_signed": true,
        "is_tampered": false
      },
      "description": null,
      "is_requested": true,
      "ocr_data": { "company_name": "Sante Clinics SL", "registration_number": "B12345678" },
      "is_console_upload": false,
      "is_confirmed": true
    }
  ],
  "groups": {
    "incorporation_certificate": { "total": 1, "approved": 1, "pending": 0, "declined": 0, "in_review": 0, "other": 0, "missing": 0 }
  },
  "required_groups": ["incorporation_certificate", "shareholder_register"],
  "warnings": []
}

KYB-Schlüsselperson

Wird pro Schlüsselpersonen-Knoten eines KYB-Workflows zurückgegeben. Erscheint als key_people_checks[] in GET /v3/session/{sessionId}/decision/ für Unternehmenssitzungen. Quelle: kyb/serializers/kyb.py:967-1050 (KeyPeopleCheckV3Serializer).

Feld	Typ	Nullable	Beschreibung	Beispiel
`status`	string	Nein	Siehe Status-Enum.	`"Approved"`
`node_id`	string \| null	Ja	Workflow-Knoten-Kennung (V3).	`"first_key_people"`
`registry`	object	Nein	`{ officers[], beneficial_owners[] }`, aus dem Register extrahiert. Organmitglieder folgen `KYBPersonResponseSerializer` (`kyb/serializers/kyb.py:533-645`); wirtschaftlich Berechtigte folgen `KYBBeneficialOwnerResponseSerializer` (`kyb/serializers/kyb.py:648-788`), der zusätzlich `date_of_birth`, `country_of_birth`, `email`, `company_name`, `registration_number`, `entity_type`, `roles`, `ownership_min_shares`, `ownership_max_shares`, `child_beneficial_owners` und `effective_ownership_percent` enthält. Beide enthalten die AML- und KYC-Anreicherung je Partei (`aml_status`, `kyc_status`, `kyc_session_url`, `kyc_session_id`, `verification_workflow_type`, `verification_workflow_id`, `verification_workflow_label`, `verification_workflow_features`, `didit_internal_id`, `kyc_document_type`, `kyc_nationality`, `kyc_liveness_passed`, `kyc_verified_at`, `kyc_aml_categories`, `kyc_notification_sent_at`).	`{ "officers": [...], "beneficial_owners": [...] }`
`submitted`	object	Nein	`{ parties[] }` - Einträge, die das Unternehmen über den Schlüsselpersonen-Ablauf bestätigt oder eingereicht hat (`BusinessParty`-Zeilen mit `source=USER`). Für jede Partei gilt `BusinessPartySubmissionResponseSerializer` (`kyb/serializers/party.py:146-194`): `uuid`, `entity_type`, `source`, `name`, `first_name`, `last_name`, `company_name`, `registration_number`, `email`, `nationality`, `phone_number`, `date_of_birth`, `position`, `custom_fields`, `is_active`, `is_skipped`, `requires_verification`, `roles[]` (`{ role, ownership_percent, voting_percent }`), `kyc_session_id`, `kyc_session_status`, `kyc_session_url`, `kyc_session_deleted`, `kyb_sub_session_id`, `kyb_sub_session_status`, `kyb_sub_session_url`, `kyb_sub_session_deleted`, `verification_workflow_type`, `verification_workflow_id`, `verification_workflow_label`, `verification_workflow_features`, `didit_internal_id`. `kyc_session_deleted` / `kyb_sub_session_deleted` kennzeichnen eine gelöschte untergeordnete Sitzung: Deren Status bleibt auf dem letzten Stand eingefroren, die zugehörige `*_session_url` wird als `null` zurückgegeben, weil der Link nicht mehr aufgelöst werden kann, und die Partei blockiert die übergeordnete Sitzung nicht mehr (die Prüfung fällt stattdessen auf `In Review`). Setzen Sie dies mit `PATCH /v3/session/{id}/kyb/parties/{party_uuid}/` zurück.	`{ "parties": [...] }`
`ubo_kyc_summary`	object	Ja	Zählwerte über aktive UBOs mit verknüpftem KYC: `{ total, approved, flagged, pending }`. `null`, wenn keine aktiven UBOs mit verknüpftem KYC vorhanden sind.	`{ "total": 2, "approved": 2, "flagged": 0, "pending": 0 }`
`warnings`	array	Nein	Siehe Warnungsobjekt.	`[]`

{
  "status": "Approved",
  "node_id": "first_key_people",
  "registry": {
    "officers": [
      {
        "uuid": "c1f1e2c2-aaaa-4d2c-9eb6-fdc6c7c92ef9",
        "name": "María García López",
        "designation": "Administrador único",
        "role": "Director",
        "nationality": "ESP",
        "appointment_date": "2018-03-22",
        "termination_date": null,
        "is_active": true,
        "address": "Calle Mayor 1, 28001 Madrid",
        "aml_status": "Approved",
        "kyc_status": "Approved",
        "kyc_session_url": "https://verify.didit.me/s/…",
        "kyc_session_id": "9b1f1e2c-8888-4d2c-9eb6-fdc6c7c92ef9",
        "verification_workflow_type": "kyc",
        "verification_workflow_id": "11111111-1111-1111-1111-111111111111",
        "verification_workflow_label": "KYB officer KYC",
        "verification_workflow_features": [
          { "feature": "ID_VERIFICATION", "status": "Approved" },
          { "feature": "LIVENESS", "status": "Approved" },
          { "feature": "FACE_MATCH", "status": "Approved" }
        ],
        "didit_internal_id": "user-12345",
        "kyc_document_type": "Passport",
        "kyc_nationality": "ESP",
        "kyc_liveness_passed": true,
        "kyc_verified_at": "2026-05-17T10:10:11Z",
        "kyc_aml_categories": [],
        "kyc_notification_sent_at": "2026-05-15T08:00:00Z"
      }
    ],
    "beneficial_owners": []
  },
  "submitted": {
    "parties": [
      {
        "uuid": "d1f1e2c2-bbbb-4d2c-9eb6-fdc6c7c92ef9",
        "entity_type": "person",
        "source": "USER",
        "name": "María García López",
        "first_name": "María",
        "last_name": "García López",
        "company_name": null,
        "registration_number": null,
        "email": "maria.garcia@example.com",
        "nationality": "ESP",
        "phone_number": null,
        "date_of_birth": "1990-05-12",
        "position": "Administrador único",
        "custom_fields": {},
        "is_active": true,
        "is_skipped": false,
        "requires_verification": true,
        "roles": [
          { "role": "UBO", "ownership_percent": 75.0, "voting_percent": null }
        ],
        "kyc_session_id": "9b1f1e2c-8888-4d2c-9eb6-fdc6c7c92ef9",
        "kyc_session_status": "Approved",
        "kyc_session_url": "https://verify.didit.me/s/…",
        "kyb_sub_session_id": null,
        "kyb_sub_session_status": null,
        "kyb_sub_session_url": null,
        "verification_workflow_type": "kyc",
        "verification_workflow_id": "11111111-1111-1111-1111-111111111111",
        "verification_workflow_label": "KYB officer KYC",
        "verification_workflow_features": [
          { "feature": "ID_VERIFICATION", "status": "Approved" },
          { "feature": "LIVENESS", "status": "Approved" }
        ],
        "didit_internal_id": "user-12345"
      }
    ]
  },
  "ubo_kyc_summary": { "total": 1, "approved": 1, "flagged": 0, "pending": 0 },
  "warnings": []
}

Felder auf Entscheidungsebene

Diese Schlüssel stehen neben den Funktions-Arrays bei GET /v3/session/{sessionId}/decision/ und innerhalb von decision in einem Webhook.

Feld	Typ	Nullable	Beschreibung
`status_override`	Objekt	Ja	`{ overridden_at, automatic_status }`, nachdem ein Prüfer `status` manuell gesetzt hat; `null`, wenn es sich um den automatisch ermittelten Status handelt.
`decision_trace`	Objekt	Nein	Wie der Status zustande kam: `status`, `decided_by` (`manual`, `automatic` oder `investigator`), `decided_at`, `automatic_status`, `terminal_node_id`, `actor`, `warning_counts` und `status_warnings`.
`linked_records`	Objekt	Ja	Zusammenfassungen zu `same_face`, `earlier_verifications` und `networks`; `null`, wenn es nichts anzuzeigen gibt.
`biometric_retention`	Objekt	Nein	`{ jurisdictions, deletes_at }`. `deletes_at` ist das Datum, an dem die biometrischen Live-Daten der Sitzung gelöscht werden, und `null`, wenn noch kein Datum gilt.
`database_validation_not_performed_reason`	Objekt	Ja	`{ code, message }`, das erklärt, warum eine konfigurierte Datenbankvalidierung kein Ergebnis erzeugt hat.
`assignee`, `waiting_since`, `sla_due_at`	Objekt, Datum und Uhrzeit	Ja	Der Console-Prüfer, dem die Sitzung zugewiesen ist, und die Prüfungsuhr der Sitzung; die Uhr ist `null`, sofern die Sitzung nicht im Status `In Review` ist.
`shared_from_session`, `shared_from_session_number`	UUID, Ganzzahl	Ja	Die Quellsitzung einer importierten Sitzung.
`sandbox_scenario`	Zeichenkette	Ja	Das Szenario, mit dem eine Sandbox-Sitzung erstellt wurde.
`fraud_check`	Objekt	Ja	Das Ergebnis der Fraud Check API; `null` für alle anderen Sitzungen.
`full_session_video`, `full_session_video_recorded_at`	URL, Datum und Uhrzeit	Ja	Die Aufnahme und der Zeitpunkt, zu dem sie entstand. Wird nur zurückgegeben, wenn Ihre Organisation Video der gesamten Sitzung aufzeichnet.

Informationen zum Lesen dieser Felder finden Sie unter Sitzung abrufen.

Biometrische Einwilligung

Jede Entscheidung zur Benutzerverifizierung und jeder Sitzungs-Webhook enthält ein einzelnes biometric_consent-Objekt (kein Array). Es gibt an, ob die Sitzung eine ausdrückliche biometrische Einwilligung erforderte, warum dies erforderlich war und welcher Nachweis für die Antwort vorliegt. Es ist null, wenn die Sitzung nie ausgewertet wurde, zum Beispiel bei einem Workflow ohne Gesichtsaufnahme. Quelle: BiometricConsentDecisionSerializer (sessions/serializers/biometric_consent.py). Wann der Schritt erscheint und was die einzelnen Fälle bedeuten, wird unter Biometrische Einwilligung erklärt. Felder ohne erfassten Wert sind null, niemals ein leerer String.

Feld	Typ	Beschreibung
`required`	boolean	Ob die Sitzung eine ausdrückliche biometrische Einwilligung einholen muss. Wird nie wieder auf `false` zurückgesetzt.
`trigger`	string (Enum) \| null	Warum eine Einwilligung erforderlich ist oder wie sie erfüllt wurde: `declared_state`, `ip_state`, `ip_unknown`, `document_issuer`, `forced` (der Modus der Anwendung ist Immer), `customer_collected` (Sie haben `biometric_consent` bei der Sitzungserstellung gesendet). `null`, solange keine Einwilligung erforderlich ist.
`status`	string (Enum)	`not_required`, `pending` (erforderlich, nicht erteilt), `given`, `declined` (eine Ablehnung wurde erfasst; derzeit bietet kein Didit-Bildschirm eine Ablehnung an).
`given_at`	string (ISO 8601) \| null	Zeitpunkt, zu dem die Einwilligung erteilt wurde. Bei `customer_collected` der von Ihnen gesendete `given_at`-Wert.
`declined_at`	string (ISO 8601) \| null	Zeitpunkt, zu dem eine Ablehnung erfasst wurde.
`text_version`	string \| null	Versionskennung des Einwilligungstexts, den die Person beantwortet hat, oder des von Ihnen gesendeten Texts.
`text_hash`	string \| null	SHA-256 (hex) des exakt angezeigten Texts in der Sprache, in der er angezeigt wurde.
`locale`	string \| null	Sprache, in der der Text angezeigt wurde.
`policy_url`	string \| null	Die Richtlinie zu biometrischen Daten, auf die der Schritt verlinkt hat.
`step`	string \| null	Workflow-Schritt, auf dem sich die Sitzung befand, als die Person geantwortet hat (zum Beispiel `LIVENESS`).
`node_id`	string \| null	Workflow-Graph-Knoten, auf dem sich die Sitzung befand, als die Person geantwortet hat.
`ip_address`	string \| null	Adresse, von der die Antwort kam.
`ip_country_code`	string \| null	ISO-3166-1-Alpha-2-Ländercode der Adresse der Antwort.
`ip_state`	string \| null	ISO-3166-2-Region der Adresse der Antwort (zum Beispiel `US-IL`).
`ip_city`	string \| null	Stadt der Adresse der Antwort.
`user_agent`	string \| null	User Agent der Anfrage, mit der geantwortet wurde.
`detected_ip_address`	string \| null	Adresse der Person, von der die Anforderung zuletzt ausgewertet wurde. Kann sich von `ip_address` unterscheiden, wenn die Person auf einem anderen Gerät geantwortet hat.
`detected_country_code`	string \| null	ISO-3166-1-Alpha-2-Ländercode der erkannten Adresse.
`detected_state`	string \| null	ISO-3166-2-Region der erkannten Adresse.
`detected_city`	string \| null	Stadt der erkannten Adresse.
`declared_state`	string \| null	Von Ihnen angegebene ISO-3166-2-Region: `user_state` oder der Bundesstaat einer US-Adresse in `expected_details`.
`document_state`	string \| null	ISO-3166-2-Untergliederung, in der das Identitätsdokument ausgestellt wurde, beim Erfassen des Ausweises gelesen.
`jurisdictions`	array of string	US-Bundesstaaten (USPS-Codes, zum Beispiel `IL`), für die das Biometrie-Gesetz für die Person gilt. `US`, wenn die Nachweise die Person in den USA verorten, aber kein Bundesstaat bekannt ist. Leer, wenn keines zutrifft.
`retention_months`	integer \| null	Die kürzeste biometrische Aufbewahrungsfrist in Monaten für die `jurisdictions`. `null`, wenn keines zutrifft.
`reason`	string (Enum) \| null	`BIOMETRIC_CONSENT_UNSUPPORTED_SDK`: Eine Einwilligung war erforderlich, und ein natives SDK unterhalb von 4.10.0 oder ein SDK, das seine Version nicht gemeldet hat, hat ein Gesicht ohne den Schritt erfasst. `status` bleibt `pending`, oder `given`, wenn die Person später auf der gehosteten Verifizierungsseite zugestimmt hat. `BIOMETRIC_CONSENT_DECLINED`: Eine Ablehnung wurde erfasst (sie ersetzt den SDK-Grund). Sonst `null`, und immer `null`, wenn die Sitzung keine Einwilligung erforderte.
`decline_reason`	string \| null	`BIOMETRIC_CONSENT_DECLINED`, wenn eine erfasste Ablehnung die Sitzung beendet hat, sonst `null`.
`face_data_deleted_at`	string (ISO 8601) \| null	Zeitpunkt, zu dem die Ablehnung die Gesichtsbilder, Videos und biometrischen Templates der Sitzung gelöscht hat. `null`, solange keine Ablehnung erfasst wurde.

Eine Sitzung in Illinois, die mit einem nativen SDK unterhalb von 4.10.0 durchgeführt wurde und bei der das Selfie ohne den Schritt aufgenommen wurde:

{
  "required": true,
  "trigger": "ip_state",
  "status": "pending",
  "given_at": null,
  "declined_at": null,
  "text_version": null,
  "text_hash": null,
  "locale": null,
  "policy_url": null,
  "step": null,
  "node_id": null,
  "ip_address": null,
  "ip_country_code": null,
  "ip_state": null,
  "ip_city": null,
  "user_agent": null,
  "detected_ip_address": "203.0.113.42",
  "detected_country_code": "US",
  "detected_state": "US-IL",
  "detected_city": "Chicago",
  "declared_state": null,
  "document_state": null,
  "jurisdictions": ["IL"],
  "retention_months": 36,
  "reason": "BIOMETRIC_CONSENT_UNSUPPORTED_SDK",
  "decline_reason": null,
  "face_data_deleted_at": null
}

Eine Person über ein VPN mit Ausgang außerhalb der USA, die auf der gehosteten Verifizierungsseite zugestimmt hat:

{
  "required": true,
  "trigger": "declared_state",
  "status": "given",
  "given_at": "2026-10-13T18:31:07.412000Z",
  "declined_at": null,
  "text_version": "bio-consent-2026-10-12",
  "text_hash": "9b2f0c5e4d8a7f61c3e2b4a5d6f7081923a4b5c6d7e8f90a1b2c3d4e5f6a7b8c",
  "locale": "en",
  "policy_url": "https://didit.me/legal/biometric-data-policy",
  "step": "LIVENESS",
  "node_id": "feature_liveness_1",
  "ip_address": "198.51.100.23",
  "ip_country_code": "ES",
  "ip_state": "ES-M",
  "ip_city": "Madrid",
  "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/604.1",
  "detected_ip_address": "198.51.100.23",
  "detected_country_code": "ES",
  "detected_state": "ES-M",
  "detected_city": "Madrid",
  "declared_state": null,
  "document_state": null,
  "jurisdictions": ["IL"],
  "retention_months": 36,
  "reason": null,
  "decline_reason": null,
  "face_data_deleted_at": null
}

Status-Aufzählung

Zwei verwandte Wertebereiche verwenden den Feldnamen status. Jedes Berichtsobjekt auf Funktionsebene auf dieser Seite verwendet die Aufzählung auf Funktionsebene. Der Top-Level-status der übergeordneten Sitzung verwendet die umfassendere Sitzungsaufzählung.

Status auf Funktionsebene

Wird vom Feld status jedes Berichtsobjekts verwendet. Quelle: common/config/choices.py:343-348 (FeatureStatusChoices).

Wert	Bedeutung
`Not Finished`	Die Funktion wurde bereitgestellt, der Benutzer hat sie aber noch nicht abgeschlossen.
`Approved`	Die Funktion hat alle Prüfungen bestanden.
`Declined`	Die Funktion hat mindestens eine harte Prüfung nicht bestanden (siehe `warnings[]` mit `log_type: "error"`).
`In Review`	Die Funktion hat weiche Fehlersignale ausgelöst und wartet auf die manuelle Prüfung (siehe `warnings[]` mit `log_type: "warning"`).
`Resub Requested`	Ein Prüfer hat den Benutzer aufgefordert, diese Funktion erneut einzureichen.

Telefonverifizierung, E-Mail-Verifizierung und Ausweisverifizierung können zusätzlich Expired zurückgeben, wenn ihr Schritt abläuft (PhoneStatusChoices in common/config/choices.py:377-382, EmailStatusChoices in common/config/choices.py:434-439).

Status auf Sitzungsebene

Wird vom Top-Level-status der übergeordneten Sitzung verwendet. Quelle: common/config/choices.py:106-117 (StatusChoices).

Wert	Bedeutung
`Not Started`	Die Sitzung wurde erstellt, der Benutzer hat sie aber noch nicht begonnen.
`In Progress`	Der Benutzer hat den Ablauf gestartet, das Ergebnis ist noch nicht endgültig.
`Approved`	Die Sitzung hat alle Prüfungen bestanden.
`Declined`	Die Sitzung hat mindestens eine harte Prüfung nicht bestanden.
`In Review`	Die Sitzung wartet auf die manuelle Prüfung.
`Expired`	Die Sitzung ist abgelaufen, bevor sie abgeschlossen wurde.
`Abandoned`	Der Benutzer hat den Ablauf verlassen, ohne ihn abzuschließen.
`Kyc Expired`	Das Gültigkeitsfenster des KYC ist abgelaufen (wird in Abläufen zur erneuten Verifizierung verwendet).
`Resubmitted`	Der Benutzer hat nach einer früheren Ablehnung erneut eingereicht; diese Sitzung wurde durch eine neuere ersetzt.
`Awaiting User`	Das System wartet auf eine Aktion des Benutzers (z. B. die Eingabe eines OTP).

Die endgültigen Sitzungswerte sind Approved, Declined, In Review, Expired, Kyc Expired und Abandoned. Eine Sitzung kann ihre Gesamtentscheidung erreichen, während eine einzelne Funktion weiterhin In Review ist.