Vai al contenuto principale
GET
curl

Panoramica

Restituisce informazioni su un’eliminazione in blocco di sessioni avviata con Batch Delete Sessions: il suo stato, quante sessioni ha elaborato e quante si sono concluse con ciascun esito. Quando un’eliminazione in batch selezionata con session_numbers oppure con delete_all riguarda più di 20 sessioni KYC, la richiesta restituisce 202 con un job PENDING e le sessioni vengono eliminate in background. Interroga questo endpoint ogni pochi secondi finché status non è COMPLETED o FAILED. Ogni sessione che il job elimina viene cancellata esattamente come con Delete Session: la sessione, ogni tentativo di verifica associato a essa e tutti i file archiviati vengono eliminati, e i suoi URL multimediali non sono più risolvibili. L’eliminazione è definitiva e irreversibile. Il job riporta solo conteggi. Non elenca mai le sessioni che ha eliminato.

Stato del job

Un job delete_all elimina solo le sessioni create prima della richiesta. Le sessioni avviate mentre il job è in esecuzione non vengono eliminate.

Conteggi degli esiti

deleted_child_verifications conta le verifiche che le verifiche aziendali eliminate avevano creato e che sono state eliminate insieme a esse. Per un job avviato da Batch Delete Sessions, che elimina solo sessioni KYC, è sempre 0.

Autorizzazioni

Qualsiasi chiave API attiva dell’applicazione può chiamare questo endpoint. Un job è visibile solo all’applicazione che lo ha creato; qualsiasi altro job_id restituisce 404.

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.

Parametri del percorso

job_id
string<uuid>
obbligatorio

Il job_id restituito con il 202 da POST /v3/sessions/delete/.

Risposta

Il job.

Un'eliminazione massiva di sessioni in esecuzione in background: avanzamento e conteggi per esito, mai quali sessioni sono state eliminate.

job_id
string<uuid>

Esegui il polling di GET /v3/sessions/delete/{job_id}/ con questo id.

status
enum<string>

PENDING: accettato, non ancora avviato. PROCESSING: eliminazione in corso; processed e outcomes si stanno aggiornando. COMPLETED: ogni sessione selezionata è stata gestita. FAILED: il job si è interrotto prima del completamento; vedi error.

Opzioni disponibili:
PENDING,
PROCESSING,
COMPLETED,
FAILED
total
integer

Sessioni selezionate al momento della richiesta di eliminazione.

processed
integer

Sessioni completate dal processo fino a questo momento.

outcomes
object

Quante sessioni si sono concluse con ciascun esito. Ogni chiave è sempre presente.

deleted_child_verifications
integer

Verifiche create dalle verifiche aziendali eliminate, eliminate insieme a esse. Sempre 0 per un processo avviato da POST /v3/sessions/delete/, che elimina solo sessioni KYC.

error
string | null

null a meno che status non sia FAILED; in tal caso, indica il motivo per cui l'eliminazione si è interrotta. Le sessioni non ancora raggiunte dal processo rimangono invariate: ripeti la richiesta per eliminarle.

created_at
string<date-time>

Data e ora della richiesta di eliminazione.

completed_at
string<date-time> | null

Quando il processo è terminato; null mentre è in esecuzione.

Ultima modifica il 7 novembre 2026