Passer au contenu principal
POST
curl

Vue d’ensemble

Supprime une ou plusieurs entreprises. Les enregistrements des entreprises sont supprimés définitivement. Les sessions de vérification d’entreprise (KYB) ne sont pas couvertes par cet endpoint : elles sont conservées, leur lien avec l’entreprise étant effacé. Supprimez-les avec Supprimer une session. Les transactions ne sont pas non plus couvertes : supprimez-les avec Suppression en lot des transactions.

Quand l’utiliser

  • Demandes de droit à l’effacement.
  • Nettoyage des entreprises de test pendant la QA.
  • Déprovisionnement des entreprises retirées de votre propre plateforme.

Remarques

  • Accepte une liste de valeurs vendor_data ou de valeurs didit_internal_id.
  • Idempotent : supprimer une entreprise déjà supprimée ne produit aucun effet.
  • Renvoie uniquement le nombre d’éléments supprimés, et non un rapport par élément. Les valeurs qui ne correspondent à rien sont ignorées silencieusement.
  • Émet business.data.updated avec deleted_at renseigné.
  • Les enregistrements appartenant à l’entreprise elle-même sont supprimés avec elle : ses liens de tags, son historique de commentaires, ainsi que ses propres enregistrements d’appareil et de réseau.
  • Les enregistrements produits par une session KYB ne sont PAS supprimés : les données du registre des sociétés, les documents téléversés, les résultats AML, les bénéficiaires effectifs et les contrôles des personnes clés appartiennent à la session et subsistent jusqu’à ce que vous supprimiez la session elle-même.

Données dans un rapport réglementaire finalisé

Si l’une des entreprises sélectionnées fait partie d’un dossier comportant un rapport réglementaire finalisé, la requête entière renvoie 409 et rien n’est supprimé. La réponse utilise code: in_filed_report et nomme chaque rapport :
Supprimez chaque rapport avec Supprimer le rapport, puis répétez la même requête.

Une suppression déjà en cours

Une entreprise est supprimée par une seule requête à la fois. Si une autre requête supprime encore l’une des entreprises sélectionnées, cette requête attend quelques secondes au maximum, puis renvoie 409 avec code: subject_deletion_in_progress et ne supprime rien :
Répétez la même requête une fois l’autre suppression terminée. Une entreprise déjà supprimée par la première requête ne correspond plus : la répétition ne supprime donc que ce qui reste.

Autorisations

Le rôle doit accorder delete:businesses. Cette autorisation est généralement réservée aux rôles OWNER et ADMIN.

Voir aussi

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Corps

application/json

Fournissez vendor_data_list, didit_internal_id_list ou delete_all: true. Ordre de priorité si plusieurs sont envoyés : delete_all > vendor_data_list > didit_internal_id_list (seul le sélecteur ayant la priorité la plus élevée est utilisé).

vendor_data_list
string[]

Vos propres identifiants à supprimer, mis en correspondance exacte avec ceux transmis.

didit_internal_id_list
string<uuid>[]

UUID internes Didit (didit_internal_id) à supprimer.

delete_all
boolean
défaut:false

Si true, supprime toutes les entreprises de l'application. Ne peut pas être combiné avec les sélecteurs de liste.

Réponse

Entreprises supprimées. Renvoie le nombre de lignes effectivement supprimées.

deleted
integer

Nombre d'entreprises supprimées (exclut les valeurs de vendor_data qui ne correspondaient à rien).

Dernière modification le 7 novembre 2026