Vai al contenuto principale
POST
Python

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 aziendale (KYB). Deve appartenere all'applicazione della chiave API.

Esempio:

"33333333-4444-5555-6666-777777777777"

Parametri della query

node_id
string

Nodo del workflow del passaggio KYB. Necessario solo quando il workflow contiene più di un nodo KYB; per impostazione predefinita Didit utilizza il nodo della sessione stessa.

Corpo

application/json
locale
string

Locale utilizzato per tradurre la risposta del passaggio a cui avanza la sessione.

Maximum string length: 10

Risposta

Parti dichiarate (o già dichiarate).

valid
boolean
next_step
string | null

Passaggio in cui si trova la sessione.

status
string

Stato della sessione aziendale.

advanced
boolean

true quando questa chiamata ha dichiarato le parti e ha fatto avanzare la sessione.

already_submitted
boolean

true quando le parti erano state dichiarate da una chiamata precedente.

kyb_key_people_status
string
parties
object[]
Ultima modifica il 7 novembre 2026