Zum Hauptinhalt springen
POST
curl

Überblick

Löscht eine oder mehrere Unternehmensentitäten. Die Unternehmensdatensätze werden dauerhaft entfernt. Sitzungen für die Unternehmensverifizierung (KYB) werden von diesem Endpoint nicht erfasst. Sie bleiben erhalten, und ihre Verknüpfung mit dem Unternehmen wird entfernt. Löschen Sie sie mit Sitzung löschen. Transaktionen werden ebenfalls nicht erfasst. Löschen Sie sie mit Transaktionen im Batch löschen.

Wann verwenden

  • Anfragen zum Recht auf Vergessenwerden.
  • Bereinigung von Testunternehmen während der QA.
  • Deprovisionierung von Unternehmen, die von Ihrer eigenen Plattform entfernt wurden.

Hinweise

  • Akzeptiert eine Liste von vendor_data-Werten oder didit_internal_id-Werten.
  • Idempotent: Das Löschen eines bereits gelöschten Unternehmens hat keine Wirkung.
  • Gibt nur die Anzahl der gelöschten Elemente zurück, keinen Bericht pro Element. Werte ohne Treffer werden stillschweigend übersprungen.
  • Sendet business.data.updated mit gesetztem deleted_at.
  • Datensätze, die der Unternehmensentität selbst gehören, werden mit ihr gelöscht: ihre Tag-Verknüpfungen, ihr Kommentarverlauf sowie ihre eigenen Geräte- und Netzwerkdatensätze.
  • Datensätze, die durch eine KYB-Sitzung entstehen, werden NICHT mitgelöscht: Unternehmensregisterdaten, hochgeladene Dokumente, AML-Treffer, wirtschaftlich Berechtigte und Prüfungen der Schlüsselpersonen gehören zur Sitzung und bleiben erhalten, bis Sie die Sitzung selbst löschen.

Daten in einem finalisierten regulatorischen Bericht

Wenn ein ausgewähltes Unternehmen Teil eines Falls mit einem finalisierten regulatorischen Bericht ist, gibt die gesamte Anfrage 409 zurück, und nichts wird gelöscht. Die Antwort enthält code: in_filed_report und nennt jeden Bericht:
Löschen Sie jeden Bericht mit Bericht löschen und wiederholen Sie dann dieselbe Anfrage.

Eine laufende Löschung

Ein Unternehmen wird jeweils nur durch eine Anfrage gelöscht. Wenn eine andere Anfrage gerade eines der ausgewählten Unternehmen löscht, wartet diese Anfrage höchstens einige Sekunden. Danach gibt sie 409 mit code: subject_deletion_in_progress zurück und löscht nichts:
Wiederholen Sie dieselbe Anfrage, sobald die andere Löschung abgeschlossen ist. Ein Unternehmen, das die andere Anfrage bereits gelöscht hat, passt nicht mehr, daher löscht die Wiederholung nur noch die verbleibenden Unternehmen.

Berechtigungen

Die Rolle muss delete:businesses gewähren. In der Regel ist diese Berechtigung OWNER und ADMIN vorbehalten.

Verwandte Themen

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Body

application/json

Geben Sie vendor_data_list, didit_internal_id_list oder delete_all: true an. Rangfolge, wenn mehrere gesendet werden: delete_all > vendor_data_list > didit_internal_id_list (nur der Selektor mit dem höchsten Vorrang wird verwendet).

vendor_data_list
string[]

Ihre eigenen zu löschenden Kennungen, exakt so abgeglichen wie übermittelt.

didit_internal_id_list
string<uuid>[]

Zu löschende interne Didit-UUIDs (didit_internal_id).

delete_all
boolean
Standard:false

Wenn true, werden alle Unternehmen in der Anwendung gelöscht. Kann nicht mit den Listen-Selektoren kombiniert werden.

Antwort

Unternehmen gelöscht. Gibt die Anzahl der tatsächlich entfernten Zeilen zurück.

deleted
integer

Anzahl der gelöschten Unternehmen (schließt vendor_data-Werte aus, die mit nichts übereinstimmten).

Zuletzt geändert am 7. November 2026