Passer au contenu principal
GET
curl
Récupérez les entrées d’une liste, de la plus récente à la plus ancienne, avec une recherche facultative. search retrouve une partie de la valeur ou du libellé d’une entrée, sans tenir compte de la casse ; reference_session_id limite les résultats aux entrées issues d’une seule session de vérification. Sur une liste de visages, metadata.face_image_source indique à quel visage de la session chaque entrée correspond (liveness si le champ est absent). Les entrées faciales et de documents contiennent dans metadata des URL d’images qui expirent peu après l’appel. Récupérez à nouveau les entrées pour obtenir de nouvelles URL plutôt que de les stocker. Une clé API sans media: read reçoit null pour ces URL.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

list_uuid
string<uuid>
requis

UUID de la liste, tel que renvoyé par Lister les listes ou Créer une liste.

Paramètres de requête

Texte insensible à la casse que la value ou le display_label de l'entrée doit contenir.

reference_session_id
string<uuid>

Uniquement les entrées issues de cette session de vérification d'une personne, par exemple pour voir lesquels de ses visages sont déjà répertoriés.

limit
integer
défaut:50

Taille de page. Vaut 50 par défaut. Une valeur supérieure à 1000000 renvoie 400 ; une valeur égale à zéro, négative ou non numérique repasse par défaut à 50.

Plage requise: 1 <= x <= 1000000
offset
integer
défaut:0

Indice de départ (base zéro) du premier élément à retourner. Privilégiez l'utilisation de next. Une valeur supérieure à 1000000 retourne 400 ; une valeur négative ou non numérique revient par défaut à 0.

Plage requise: 0 <= x <= 1000000

Réponse

Une page d'entrées, les plus récentes en premier.

count
integer
requis

Nombre total d'entrées correspondant aux filtres.

Plage requise: x >= 0
next
string<uri> | null
requis

URL absolue de la page suivante, ou null sur la dernière page.

previous
string<uri> | null
requis

URL absolue de la page précédente, ou null sur la première page.

results
object[]
requis
Dernière modification le 7 novembre 2026