Vai al contenuto principale
POST
curl

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.

Intestazioni

Content-Type
string

Imposta su application/json quando invii un corpo JSON.

Esempio:

"application/json"

Parametri del percorso

session_id
string<uuid>
obbligatorio

UUID della sessione di Verifica degli utenti (KYC). Deve appartenere alla stessa applicazione della chiave API: gli UUID appartenenti ad altre applicazioni, le sessioni eliminate e gli ID di sessione di Verifica aziendale (KYB) restituiscono tutti 404.

Esempio:

"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d"

Corpo

application/json
new_status
enum<string> | null

Etichetta di stato opzionale da registrare nella voce. Accetta qualsiasi valore di stato della sessione, con distinzione tra maiuscole e minuscole ("approved" viene rifiutato con 400). La registrazione di uno stato qui non modifica lo stato effettivo della sessione: usa l'endpoint di aggiornamento dello stato a tale scopo.

Opzioni disponibili:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Esempio:

"In Review"

comment
string | null

Nota opzionale a testo libero (nessun limite di lunghezza imposto). Memorizzata letteralmente; le menzioni @email non vengono elaborate su questo endpoint.

Esempio:

"Flagging for manual document re-check."

Risposta

Voce registrata nel registro di audit della sessione. La sessione stessa rimane invariata: il suo status mantiene il valore precedente e non viene inviato alcun webhook. La nuova voce compare anche in cima a GET …/reviews/ (con actor_display: "Unknown").

user
string

Nome visualizzato dell'autore della voce. Sempre "Unknown" per le voci create tramite questo endpoint, poiché non registra l'autore.

Esempio:

"Unknown"

new_status
enum<string> | null

L'etichetta di stato registrata sulla voce, oppure null se non ne è stata inviata alcuna. Lo stato effettivo della sessione non viene modificato.

Opzioni disponibili:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Esempio:

"In Review"

comment
string | null

La nota registrata sulla voce, o null se non ne è stata inviata alcuna.

Esempio:

"Flagging for manual document re-check."

created_at
string<date-time>

Data e ora di scrittura della voce, ISO 8601 UTC.

Esempio:

"2026-06-12T00:18:44.466537Z"

Ultima modifica il 7 novembre 2026