Saltar al contingut principal
GET
curl
Recupera les entrades d’una llista, de la més recent a la més antiga, amb cerca opcional. search coincideix amb una part del valor o de l’etiqueta d’una entrada, sense distingir majúscules de minúscules. reference_session_id limita els resultats a les entrades obtingudes d’una sessió de verificació concreta. En una llista de cares, metadata.face_image_source indica a quina de les cares de la sessió correspon cada entrada (liveness si el camp no hi és). Les entrades facials i de documents contenen URL d’imatges a metadata que caduquen poc després de la crida. Torna a obtenir les entrades per obtenir URL actualitzades en lloc d’emmagatzemar-les. Una clau d’API sense media: read rep null per a aquestes URL.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

list_uuid
string<uuid>
requerit

UUID de la llista, tal com el retorna Llistar llistes o Crear una llista.

Paràmetres de consulta

Text que no distingeix majúscules de minúscules que ha de contenir el value o el display_label de l'entrada.

reference_session_id
string<uuid>

Només les entrades extretes d'aquesta sessió de verificació de persona, per exemple per veure quines de les seves cares ja estan llistades.

limit
integer
predeterminat:50

Mida de la pàgina. Per defecte és 50. Un valor superior a 1000000 retorna 400; un zero, un valor negatiu o un valor no numèric torna al valor per defecte de 50.

Rang requerit: 1 <= x <= 1000000
offset
integer
predeterminat:0

Índex basat en zero del primer element a retornar. És preferible seguir next. Un valor superior a 1000000 retorna 400; un valor negatiu o no numèric torna a 0 per defecte.

Rang requerit: 0 <= x <= 1000000

Resposta

Una pàgina d'entrades, les més recents primer.

count
integer
requerit

Nombre total d'entrades que coincideixen amb els filtres.

Rang requerit: x >= 0
next
string<uri> | null
requerit

URL absoluta de la pàgina següent, o null a l'última pàgina.

previous
string<uri> | null
requerit

URL absoluta de la pàgina anterior, o null a la primera pàgina.

results
object[]
requerit
Darrera modificació el 7 de novembre del 2026