KYB-Datenmodell für Unternehmen: Schema

Diese Seite dokumentiert jedes Feld einer Business-Entität und wie Didit die einzelnen Felder befüllt.

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.
`vendor_data`	string	Ihre Kennung für das Unternehmen. Pro Anwendung eindeutig. Weiterlesen.
`display_name`	string	Überschreibt den in der Konsole angezeigten Namen. Standardwert ist `legal_name` oder `vendor_data`.
`legal_name`	string	Rechtlicher Firmenname laut Eintragung: aus der Registerabfrage der neuesten genehmigten Unternehmensverifizierung (KYB)-Sitzung übernommen.
`registration_number`	string	Offizielle Registernummer des Unternehmens, aus dem Register übernommen.
`country_code`	string (ISO 3166-1 alpha-3)	Land der Gründung.

legal_name, registration_number und country_code sind schreibgeschützt, wenn sie aus einer verifizierten Registerabfrage stammen. Sie können manuell in der Konsole oder über PATCH /v3/businesses/{vendor_data}/ überschrieben werden; Überschreibungen werden jedoch im Audit-Log markiert.

Status

Feld	Typ	Werte	Beschreibung
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Steuert die Durchsetzungsmaßnahmen für künftige Sitzungen und Transaktionen. Siehe Lebenszyklus.

Aggregierte Sitzungsfelder

Feld	Typ	Beschreibung
`session_count`	int	Gesamtzahl aller jemals für dieses Unternehmen erstellten Unternehmensverifizierung (KYB)-Sitzungen
`approved_count`	int	Mit `Approved` abgeschlossene Sitzungen
`declined_count`	int	Mit `Declined` abgeschlossene Sitzungen
`in_review_count`	int	Aktuell `In Review` befindliche Sitzungen
`features`	object	Status der neuesten Unternehmensverifizierung unter dem Schlüssel `KYB`

Die `features`-Map

{
  "KYB": "Approved"
}

Die Map enthält einen Schlüssel, KYB, mit dem Status der neuesten Unternehmensverifizierung: "Not Finished", "Approved", "Declined", "In Review" oder "Resub Requested". Den Status der einzelnen KYB-Funktionen entnehmen Sie der Sitzungsentscheidung. Verwenden Sie die features-Map als schnellen Weg, um zu prüfen, ob ein Unternehmen aktuell vollständig verifiziert ist, ohne alle Sitzungen durchzugehen.

Aktivitätszeitstempel

Feld	Typ	Aktualisiert bei
`first_session_at`	ISO-Zeitstempel	Erste Unternehmensverifizierung (KYB)-Sitzung wurde erstellt
`last_session_at`	ISO-Zeitstempel	Neueste Sitzung wurde erstellt oder aktualisiert
`last_activity_at`	ISO-Zeitstempel	Jede Änderung: Sitzung, Transaktion, Status, Profil, Notizen
`created_at`	ISO-Zeitstempel	Entitätszeile wurde erstellt
`updated_at`	ISO-Zeitstempel	Entitätszeile wurde zuletzt aktualisiert

Metadaten

Feld	Typ	Beschreibung
`metadata`	object (JSON)	Freiform-JSON, das Sie verwalten
`tags[]`	array	Über Konsole/API verwaltete Tags

Relationen (nicht in der Unternehmenszeile gespeichert)

Relation	So greifen Sie darauf zu
Sitzungen zur Unternehmensverifizierung (KYB)	`GET /v3/sessions?vendor_data=<value>`
Verknüpfte Benutzer (Verantwortliche, UBOs, Geschäftsführer)	Auf der Detailseite des Unternehmens in der Konsole angezeigt; abgeleitet aus der neuesten genehmigten Unternehmensverifizierung (KYB)-Sitzung
Transaktionen (als Antragsteller oder Gegenpartei)	Transaktionen nach `vendor_data` des Unternehmens filtern
Dokumente	Über Entscheidungen der Unternehmensverifizierung (KYB)-Sitzungen
AML-Treffer	Über Entscheidungen der Unternehmensverifizierung (KYB)-Sitzungen

Beispielantwort

{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}

Nächste Schritte

Operationen

Erstellen, aktualisieren, Status ändern, löschen.

KYB-Verlauf

Alle mit dem Unternehmen verknüpften Sitzungen abrufen.

API-Referenz

Schema für GET /v3/businesses//.

Zuletzt geändert am 7. November 2026

Übersicht

Preise

Workflows & Verifizierung

Prüfung & Betrieb

Entitäten (Benutzer & Unternehmen)

Einstellungen & Anpassung

Sicherheit & Compliance

Didit Academy

Ressourcen

KYB-Datenmodell für Unternehmen: Schema

Identitätsfelder

Status

Aggregierte Sitzungsfelder

Die `features`-Map

Aktivitätszeitstempel

Metadaten

Relationen (nicht in der Unternehmenszeile gespeichert)

Beispielantwort

Nächste Schritte

Operationen

KYB-Verlauf

API-Referenz

​Identitätsfelder

​Status

​Aggregierte Sitzungsfelder

​Die features-Map

​Aktivitätszeitstempel

​Metadaten

​Relationen (nicht in der Unternehmenszeile gespeichert)

​Beispielantwort

​Nächste Schritte

Operationen

KYB-Verlauf

API-Referenz

Identitätsfelder

Status

Aggregierte Sitzungsfelder

Die `features`-Map

Aktivitätszeitstempel

Metadaten

Relationen (nicht in der Unternehmenszeile gespeichert)

Beispielantwort

Nächste Schritte