Vai al contenuto principale
POST
curl

Panoramica

Elimina una o più entità aziendali. I record delle aziende vengono rimossi in modo permanente. Le sessioni di Verifica aziendale (KYB) non sono coperte da questo endpoint e restano, con il collegamento all’azienda azzerato: eliminale con Elimina sessione. Anche le transazioni non sono coperte: eliminale con Eliminazione in blocco delle transazioni.

Quando usarlo

  • Richieste di diritto all’oblio.
  • Pulizia delle aziende di test durante il QA.
  • Dismissione delle aziende rimosse dalla tua piattaforma.

Note

  • Accetta un elenco di valori vendor_data o di valori didit_internal_id.
  • Idempotente: eliminare un’azienda già eliminata non produce alcun effetto.
  • Restituisce solo il conteggio di ciò che è stato eliminato, non un report per singolo elemento. I valori che non corrispondono a nulla vengono ignorati senza segnalazioni.
  • Emette business.data.updated con deleted_at valorizzato.
  • I record di proprietà dell’entità aziendale stessa vengono eliminati insieme a essa: i suoi collegamenti ai tag, la cronologia dei commenti e i propri record di dispositivo e di rete.
  • I record prodotti da una sessione KYB NON vengono eliminati: i dati del registro delle imprese, i documenti caricati, i riscontri AML, i titolari effettivi e i controlli sulle persone chiave appartengono alla sessione e restano finché non elimini la sessione stessa.

Dati in un report normativo finalizzato

Se una qualsiasi azienda selezionata fa parte di un caso con un report normativo finalizzato, l’intera richiesta restituisce 409 e non viene eliminato nulla. La risposta usa code: in_filed_report e indica ciascun report:
Elimina ciascun report con Elimina report, poi ripeti la stessa richiesta.

Un’eliminazione già in corso

Un’azienda viene eliminata da una sola richiesta alla volta. Se un’altra richiesta sta ancora eliminando una delle aziende selezionate, questa richiesta attende al massimo qualche secondo, quindi restituisce 409 con code: subject_deletion_in_progress e non elimina nulla:
Ripeti la stessa richiesta una volta completata l’altra eliminazione. Un’azienda già eliminata dalla richiesta precedente non corrisponde più, quindi la ripetizione elimina solo ciò che resta.

Autorizzazioni

Il ruolo deve concedere delete:businesses. Di norma è riservato a OWNER e ADMIN.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json

Fornisci vendor_data_list, didit_internal_id_list o delete_all: true. Ordine di precedenza quando ne vengono inviati diversi: delete_all > vendor_data_list > didit_internal_id_list (viene utilizzato solo il selettore con precedenza più alta).

vendor_data_list
string[]

I tuoi identificatori da eliminare, confrontati esattamente come inviati.

didit_internal_id_list
string<uuid>[]

UUID interni Didit (didit_internal_id) da eliminare.

delete_all
boolean
predefinito:false

Se true, elimina ogni azienda nell'applicazione. Non può essere combinato con i selettori di elenco.

Risposta

Aziende eliminate. Restituisce il numero di righe effettivamente rimosse.

deleted
integer

Numero di aziende eliminate (esclude i valori di vendor_data che non corrispondevano a nulla).

Ultima modifica il 7 novembre 2026