Saltar al contenido principal
GET
curl
Obtén las entradas de una lista, de la más reciente a la más antigua, con búsqueda opcional. search busca coincidencias con parte del valor o de la etiqueta de una entrada sin distinguir mayúsculas de minúsculas; reference_session_id limita los resultados a las entradas tomadas de una sesión de verificación concreta. En una lista de rostros, metadata.face_image_source indica a cuál de los rostros de la sesión corresponde cada entrada (liveness cuando no aparece). Las entradas de rostros y de documentos incluyen en metadata URL de imágenes que expiran poco después de la llamada. Vuelve a obtener las entradas para conseguir URL nuevas en lugar de almacenarlas. Una clave de API sin media: read recibe null para esas URL.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

list_uuid
string<uuid>
requerido

UUID de la lista, tal como lo devuelven Listar listas o Crear una lista.

Parámetros de consulta

Texto, sin distinguir mayúsculas y minúsculas, que debe contener el value o el display_label de la entrada.

reference_session_id
string<uuid>

Solo las entradas tomadas de esta sesión de verificación de persona, por ejemplo para ver cuáles de sus rostros ya están en una lista.

limit
integer
predeterminado:50

Tamaño de página. El valor predeterminado es 50. Un valor superior a 1000000 devuelve 400; cero, un valor negativo o un valor no numérico hacen que se use 50.

Rango requerido: 1 <= x <= 1000000
offset
integer
predeterminado:0

Índice, empezando en cero, del primer elemento que se devuelve. Es preferible seguir next. Un valor superior a 1000000 devuelve 400; un valor negativo o no numérico se toma como 0.

Rango requerido: 0 <= x <= 1000000

Respuesta

Una página de entradas, de la más reciente a la más antigua.

count
integer
requerido

Número total de entradas que coinciden con los filtros.

Rango requerido: x >= 0
next
string<uri> | null
requerido

URL absoluta de la página siguiente, o null en la última página.

previous
string<uri> | null
requerido

URL absoluta de la página anterior, o null en la primera página.

results
object[]
requerido
Última modificación el 1 de noviembre de 2026