Vai al contenuto principale
GET
curl

Panoramica

Restituisce una singola entità utente identificata da vendor_data. Le risposte includono didit_internal_id, l’identificativo interno stabile di Didit.

Quando usarlo

  • Ricerca dello stato di verifica attuale di un utente: la mappa features fornisce lo stato più recente di ogni funzionalità in un unico oggetto.
  • Viste di dettaglio nella tua interfaccia: recupera il profilo su richiesta prima di visualizzarlo.
  • Punteggio di rischio: combina i contatori delle sessioni e features per assegnare autonomamente un punteggio a ogni utente.

Note

  • vendor_data nell’URL è sensibile alle maiuscole e minuscole.
  • Restituisce 404 se nell’applicazione non esiste alcun utente con quel vendor_data.
  • I contatori aggregati (session_count, approved_count, declined_count, in_review_count) si aggiornano in tempo reale al completamento delle sessioni.
  • Consulta il modello dati utente per conoscere ogni campo.

Autorizzazioni

Qualsiasi chiave API attiva dell’applicazione può chiamare questo endpoint. Le chiavi API di Didit sono limitate all’applicazione, non al ruolo: i ruoli e le autorizzazioni della Console (read:users e gli altri) determinano cosa una persona può fare nella Console e non vengono valutati per il traffico della Management API. Per controllare chi può chiamare questo endpoint, controlla chi può leggere la chiave API dell’applicazione.

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

vendor_data
string
obbligatorio

Il tuo identificatore univoco per l'utente: una stringa a formato libero (NON un UUID). È lo stesso valore che hai passato come vendor_data durante la creazione della sessione che ha introdotto per la prima volta questo utente, confrontato esattamente come inviato.

Risposta

Dettaglio completo dell'utente inclusi metadati, commenti/registro delle attività e dati aggregati della sessione.

Dettaglio completo dell'utente. Estende UserListItem con metadati, commenti e updated_at.

didit_internal_id
string<uuid>

UUID interno stabile di Didit per questo utente.

vendor_data
string | null

Il tuo identificatore univoco per questo utente (passato durante la creazione delle sessioni). Può essere null se non è stato fornito alcun identificatore del fornitore.

display_name
string | null

Nome visualizzato personalizzato impostato da te

full_name
string | null

Nome completo estratto dai documenti verificati

date_of_birth
string<date> | null
effective_name
string | null

Miglior nome disponibile: display_name se impostato, altrimenti full_name

status
enum<string>

Stato del ciclo di vita del record utente (NON uno stato della sessione). ACTIVE è il valore predefinito, FLAGGED contrassegna l'utente per una verifica manuale, BLOCKED impedisce nuove sessioni per questo vendor_data.

Opzioni disponibili:
ACTIVE,
FLAGGED,
BLOCKED
portrait_image_url
string | null

URL prefirmato della foto ritratto dell'utente (scade dopo alcune ore)

session_count
integer

Numero totale di sessioni di verifica per questo utente

approved_count
integer

Numero di sessioni approvate

declined_count
integer

Numero di sessioni rifiutate

in_review_count
integer

Numero di sessioni in revisione

issuing_states
string[]

Codici ISO 3166-1 alpha-3 dei paesi di emissione rilevati nei documenti d'identità approvati di questo utente, ad es. ["USA", "ESP"]. Array vuoto se assenti.

approved_emails
string[]

Indirizzi email verificati raccolti dalle sessioni approvate di questo utente, ad es. ["john@example.com"].

approved_phones
string[]

Numeri di telefono verificati raccolti dalle sessioni approvate di questo utente, ad es. ["+14155551234"].

features
object

Stato aggregato per funzionalità in tutte le sessioni di questo utente. Chiavi possibili: ID_VERIFICATION, NFC, LIVENESS, FACE_MATCH, POA, QUESTIONNAIRE, EMAIL_VERIFICATION, PHONE, AML, IP_ANALYSIS, AGE_ESTIMATION, DATABASE_VALIDATION. Valori possibili: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Gli stessi dati di features, sotto forma di array ordinato di oggetti {feature, status}.

last_session_at
string<date-time> | null

Timestamp della sessione più recente

first_session_at
string<date-time> | null

Timestamp della prima sessione

last_activity_at
string<date-time> | null

Timestamp dell'attività più recente su questo utente (sessione, transazione, cambio di stato, modifica dei dati, ecc.).

tags
object[]

Assegnazioni dei tag. NOTA: nelle risposte di dettaglio ogni voce è un oggetto collegamento del tag ({uuid, tag: {...}, added_by_email, added_by_name, created_at}), a differenza della struttura piatta {uuid, name, color} usata nelle risposte di elenco.

created_at
string<date-time>
metadata
object

JSON di metadati personalizzati che hai allegato a questo utente. Il valore predefinito è {}.

comments
object[]

Registro delle attività e commenti per questo utente (modifiche di stato, modifiche al profilo, note manuali).

updated_at
string<date-time>
Ultima modifica il 7 novembre 2026