> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Benutzer-Datenmodell: Schema für Benutzer beim Anbieter > Alle Felder einer Didit-Benutzer-Entität: Identität, Status, KYC-Sitzungsaggregate, Biometrie, Aktivitätszeitstempel und Metadaten. Abrechnung pro Nutzung. Diese Seite dokumentiert jedes Feld einer Benutzerentität. Die Felder sind in fünf Gruppen unterteilt: Identität, Status, Sitzungsaggregate, Aktivitätszeitstempel und Metadaten. ## Identitätsfelder | Feld | Typ | Beschreibung | | - | - | - | | `uuid` | UUID | Von Didit vergebener Primärschlüssel. Stabil und eindeutig. | | `didit_internal_id` | string | Für Menschen lesbare interne Kennung (wird in API-Antworten ausgegeben). | | `vendor_data` | string | Ihre Kennung für den Benutzer. Eindeutig pro Anwendung. [Mehr erfahren](https://docs.didit.me/de/entities/vendor-data-linking.md). | | `display_name` | string | Überschreibt den in der Konsole angezeigten Namen. Ist er nicht gesetzt, wird `full_name` oder `vendor_data` verwendet. | | `full_name` | string | Vollständiger rechtlicher Name, übernommen aus dem Ausweisdokument der zuletzt genehmigten Benutzerverifizierungs-Sitzung (KYC). | | `date_of_birth` | Datum (ISO 8601) | Übernommen aus der zuletzt genehmigten Benutzerverifizierungs-Sitzung (KYC). | | `portrait_image` | URL | Signierte S3-URL für das Selfie aus der zuletzt genehmigten Liveness-Erkennung. | > [!NOTE] > > `full_name`, `date_of_birth` und `portrait_image` sind schreibgeschützt, wenn sie aus einer verifizierten Sitzung abgeleitet wurden. Sie können sie über die Konsole oder über `PATCH /v3/users/{vendor_data}/` überschreiben. Manuelle Überschreibungen werden jedoch im Audit-Log markiert. ## Status | Feld | Typ | Werte | Beschreibung | | - | - | - | - | | `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Steuert die Durchsetzung für künftige Sitzungen und Transaktionen. Siehe [Lebenszyklus](https://docs.didit.me/de/entities/lifecycle.md). | ## Felder für Sitzungsaggregate Diese Felder werden von Didit berechnet und aktualisieren sich in Echtzeit, sobald Sitzungen abgeschlossen werden. | Feld | Typ | Beschreibung | | - | - | - | | `session_count` | int | Insgesamt jemals für diesen Benutzer erstellte Sitzungen | | `approved_count` | int | Sitzungen, die mit `APPROVED` abgeschlossen wurden | | `declined_count` | int | Sitzungen, die mit `DECLINED` abgeschlossen wurden | | `in_review_count` | int | Derzeit `IN_REVIEW` befindliche Sitzungen | | `issuing_states[]` | Array mit ISO-Ländercodes | Ausstellungsländer aller Ausweisdokumente, die über Sitzungen hinweg verifiziert wurden | | `approved_emails[]` | Array mit Zeichenketten | Über die [E-Mail-Verifizierung](https://docs.didit.me/de/core-technology/email-verification/overview.md) verifizierte E-Mail-Adressen | | `approved_phones[]` | Array mit Zeichenketten | Über die [Telefonverifizierung](https://docs.didit.me/de/core-technology/phone-verification/overview.md) verifizierte Telefonnummern | | `features` | Objekt | Neuester Status jeder Funktion über alle Sitzungen | ### Die `features`-Map Jede Sitzung führt eine oder mehrere Funktionen aus (Ausweisverifizierung, Liveness-Erkennung, Gesichtsabgleich, AML, Adressnachweis (POA), NFC usw.). Die `features`-Map enthält den **neuesten** Status jeder Funktion für diesen Benutzer: ```json theme={null} { "id_verification": "APPROVED", "liveness": "APPROVED", "face_match": "APPROVED", "aml": "IN_REVIEW", "proof_of_address": "APPROVED", "nfc_verification": "NOT_FINISHED" } ``` Funktionsstatus: `NOT_FINISHED`, `APPROVED`, `DECLINED`, `IN_REVIEW`, `EXPIRED`, `ABANDONED`, `RESUB_REQUESTED`. Verwenden Sie die `features`-Map als schnellen Weg, um zu prüfen, ob ein Benutzer aktuell vollständig verifiziert ist, ohne alle Sitzungen durchzugehen. ## Aktivitätszeitstempel | Feld | Typ | Aktualisiert bei | | - | - | - | | `first_session_at` | ISO-Zeitstempel | Erste Sitzung wurde erstellt | | `last_session_at` | ISO-Zeitstempel | Letzte Sitzung wurde erstellt oder aktualisiert | | `last_activity_at` | ISO-Zeitstempel | Jede Änderung: Sitzung, Transaktion, Status, Profil, Notizen, Tags | | `created_at` | ISO-Zeitstempel | Datensatz wurde erstellt | | `updated_at` | ISO-Zeitstempel | Datensatz wurde zuletzt aktualisiert | ## Metadaten | Feld | Typ | Beschreibung | | - | - | - | | `metadata` | Objekt (JSON) | Frei gestaltbares JSON, das Sie verwalten. Verwenden Sie es für interne Tags, Stufe, Registrierungsquelle usw. | | `tags[]` | Array | In der Konsole bzw. über die API verwaltete Tags zum Filtern und Gruppieren | Metadaten haben kein Schema: Didit speichert alles, was Sie schreiben. ## Beziehungen (nicht im Benutzerdatensatz gespeichert) | Beziehung | Zugriff | | - | - | | Sitzungen | `GET /v3/sessions?vendor_data=` | | Transaktionen (als Antragsteller) | `GET /v3/transactions/?vendor_data=` | | Transaktionen (als Gegenpartei) | In der Konsole die Transaktionsliste nach vendor\_data der Gegenpartei filtern | | Verknüpfte Unternehmen (Geschäftsführer / UBO) | Wird auf der Benutzerdetailseite in der Konsole angezeigt | | Gesichtsbiometrie | Konsole und Lists API | | Sperrlisten-Einträge | [Lists API](https://docs.didit.me/de/management-api/lists/overview.md): Einträge nach den Kennungen des Benutzers filtern | ## Beispielantwort ```json theme={null} { "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a", "didit_internal_id": "U-2026-00042", "vendor_data": "user-42", "display_name": "Jane Doe", "full_name": "John Doe", "date_of_birth": "1990-01-01", "portrait_image": "https:///...", "status": "ACTIVE", "session_count": 3, "approved_count": 2, "declined_count": 0, "in_review_count": 1, "issuing_states": ["US", "ES"], "approved_emails": ["jane@example.com"], "approved_phones": ["+14155550123"], "features": { "id_verification": "APPROVED", "liveness": "APPROVED", "face_match": "APPROVED", "aml": "IN_REVIEW" }, "first_session_at": "2025-03-01T12:00:00Z", "last_session_at": "2026-04-10T09:00:00Z", "last_activity_at": "2026-04-16T10:00:00Z", "metadata": { "tier": "premium" } } ``` ## Nächste Schritte > [card] [Vorgänge](https://docs.didit.me/de/entities/users/operations.md) > > Erstellen, aktualisieren, Status ändern, löschen. > [card] [KYC-Verlauf](https://docs.didit.me/de/entities/users/kyc-history.md) > > Alle Sitzungen abrufen, die mit dem Benutzer verknüpft sind. > [card] [API-Referenz](https://docs.didit.me/de/management-api/users/get.md) > > Schema von GET /v3/users/{vendor_data}/. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.