Vai al contenuto principale
GET
curl
Leggi un’esportazione avviata con Esporta file.
  • PENDING e PROCESSING: il file ZIP è in preparazione. Rileggi l’esportazione tra qualche secondo.
  • READY: download_url è un link firmato al file ZIP che resta valido per un breve periodo. Rileggi l’esportazione per ottenere un nuovo link fino a expires_at.
  • FAILED: non è stato possibile preparare il file ZIP. Avvia una nuova esportazione.
  • EXPIRED: il file ZIP è stato eliminato. Avvia una nuova esportazione.
Ogni lettura che fornisce un link di download viene registrata nel registro di audit della sessione. Un’esportazione di una sessione eliminata restituisce 404.

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

sessionId
string<uuid>
obbligatorio

UUID della sessione di verifica (il session_id restituito da POST /v3/session/). Accetta sia ID di sessione di Verifica degli utenti (KYC) sia di Verifica aziendale (KYB). Una sessione eliminata restituisce 404.

Esempio:

"11111111-2222-3333-4444-555555555555"

exportId
string<uuid>
obbligatorio

L'export_id restituito da POST /v3/session/{sessionId}/files-export/.

Esempio:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

Risposta

L'esportazione.

Uno ZIP con tutti i file di una sessione, in qualità originale.

export_id
string<uuid>
obbligatorio

ID dell'esportazione. Passalo a GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
obbligatorio

La sessione da cui provengono i file.

status
enum<string>
obbligatorio

PENDING e PROCESSING durante la preparazione dello ZIP, READY non appena può essere scaricato, FAILED quando non è stato possibile prepararlo (richiedi una nuova esportazione), EXPIRED una volta che lo ZIP è stato eliminato.

Opzioni disponibili:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
obbligatorio

File presenti nel file ZIP. Impostato solo quando status è READY.

size_bytes
integer<int64> | null
obbligatorio

Dimensione dello ZIP in byte. Impostata solo mentre status è READY.

download_url
string<uri> | null
obbligatorio

URL firmato dello ZIP, valido per un breve periodo di tempo. Impostato solo mentre status è READY; leggi nuovamente l'esportazione per ottenerne uno nuovo.

expires_at
string<date-time> | null
obbligatorio

Data e ora di eliminazione del file ZIP, 24 ore dopo essere stato pronto. Impostato solo mentre status è READY.

error
string | null
obbligatorio

Il motivo per cui l'esportazione è fallita, quando status è FAILED.

created_at
string<date-time>
obbligatorio

Data e ora della richiesta di esportazione.

completed_at
string<date-time> | null
obbligatorio

Data e ora in cui il file ZIP era pronto o in cui l'esportazione non è riuscita.

Ultima modifica il 7 novembre 2026