Vai al contenuto principale
GET
curl
Recupera le voci di un elenco, dalla più recente alla più vecchia, con ricerca facoltativa. search corrisponde a una parte del valore o dell’etichetta di una voce, senza distinzione tra maiuscole e minuscole. reference_session_id restringe i risultati alle voci ricavate da una sessione di verifica. In un elenco di volti, metadata.face_image_source indica a quale dei volti della sessione corrisponde ciascuna voce (liveness se assente). Le voci relative a volti e documenti contengono in metadata URL di immagini che scadono poco dopo la chiamata. Richiedi di nuovo le voci per ottenere URL aggiornati, invece di memorizzarli. Una chiave API senza media: read riceve null per questi URL.

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

list_uuid
string<uuid>
obbligatorio

UUID della lista, come restituito da List lists o Create a list.

Parametri della query

Testo senza distinzione tra maiuscole e minuscole che il value o il display_label della voce deve contenere.

reference_session_id
string<uuid>

Solo le voci ricavate da questa sessione di verifica della persona, ad esempio per verificare quali dei suoi volti sono già inclusi nell'elenco.

limit
integer
predefinito:50

Dimensione della pagina. Il valore predefinito è 50. Un valore superiore a 1000000 restituisce 400; zero, un valore negativo o non numerico utilizza 50 come valore predefinito.

Intervallo richiesto: 1 <= x <= 1000000
offset
integer
predefinito:0

Indice in base zero del primo elemento da restituire. È preferibile seguire next. Un valore superiore a 1000000 restituisce 400; un valore negativo o non numerico reimposta a 0.

Intervallo richiesto: 0 <= x <= 1000000

Risposta

Una pagina di voci, dalla più recente.

count
integer
obbligatorio

Numero totale di voci corrispondenti ai filtri.

Intervallo richiesto: x >= 0
next
string<uri> | null
obbligatorio

URL assoluto della pagina successiva, o null sull'ultima pagina.

previous
string<uri> | null
obbligatorio

URL assoluto della pagina precedente, o null sulla prima pagina.

results
object[]
obbligatorio
Ultima modifica il 7 novembre 2026