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
entity_type
enum<string>
obbligatorio

Indica se la parte è una persona fisica o un'azienda.

Opzioni disponibili:
person,
company
nationality
string
obbligatorio

Nazionalità di una persona fisica o paese di costituzione di un'azienda. Obbligatorio per ogni parte.

Maximum string length: 100
full_name
string

Nome completo di una persona. Invia questo, oppure first_name e last_name.

Maximum string length: 255
first_name
string
Maximum string length: 128
last_name
string
Maximum string length: 128
role
enum<string>

Ruolo ricoperto dalla parte. Intercambiabile con roles; quando vengono inviati entrambi, vengono uniti.

Opzioni disponibili:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
roles
enum<string>[]

Ogni ruolo ricoperto dal soggetto. Una persona deve avere almeno un ruolo (qui o in role).

Opzioni disponibili:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
position
string

Qualifica professionale di una persona.

Maximum string length: 128
date_of_birth
string<date> | null
company_name
string

Nome di una parte aziendale. Obbligatorio quando entity_type è company.

Maximum string length: 255
registration_number
string

Numero di registrazione di un soggetto aziendale.

Maximum string length: 100
email
string<email>

Dove viene inviato il link di verifica. Obbligatorio quando la parte deve completare la verifica, il che dipende dalle impostazioni del ruolo e dalle soglie dell'assetto proprietario del workflow.

ownership_percent
number | null

Quota dell'azienda posseduta dal soggetto.

phone_number
string
Maximum string length: 32
custom_fields
object

Campi aggiuntivi definiti dal workflow.

skip_verification
boolean
predefinito:false

Richiedi di saltare la verifica di questa parte. Applicato solo se il ruolo della parte consente di saltarla nelle impostazioni di Persone chiave del workflow.

Risposta

Bozza creata.

draft_id
string<uuid>
obbligatorio
created_at
string<date-time>
obbligatorio
updated_at
string<date-time>
obbligatorio
party
object
obbligatorio
Ultima modifica il 7 novembre 2026