Перейти к основному содержанию
GET
curl
Получите записи одного списка, от новых к старым, с необязательным поиском. search находит совпадение с частью значения или метки записи без учета регистра. reference_session_id ограничивает результаты записями, полученными из одной сессии верификации. В списке лиц metadata.face_image_source показывает, какое из лиц сессии соответствует каждой записи (liveness, если поле отсутствует). Записи лиц и документов содержат в metadata URL изображений, которые истекают вскоре после вызова. Чтобы получить новые URL, запросите записи повторно и не сохраняйте старые. API-ключ без разрешения media: read получает null вместо этих URL.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

list_uuid
string<uuid>
обязательно

UUID списка, возвращённый методами List lists или Create a list.

Параметры запроса

Текст без учёта регистра, который должно содержать поле value или display_label записи.

reference_session_id
string<uuid>

Только записи, полученные из этой сессии верификации личности, например, чтобы увидеть, какие из её лиц уже внесены в списки.

limit
integer
по умолчанию:50

Размер страницы. По умолчанию 50. Значение больше 1000000 возвращает 400; для нулевого, отрицательного или нечислового значения используется 50.

Требуемый диапазон: 1 <= x <= 1000000
offset
integer
по умолчанию:0

Индекс первого возвращаемого элемента, начиная с нуля. Рекомендуется переходить по ссылке next. Значение больше 1000000 возвращает 400; отрицательное или нечисловое значение сбрасывается на 0.

Требуемый диапазон: 0 <= x <= 1000000

Ответ

Страница записей, начиная с самых новых.

count
integer
обязательно

Общее количество записей, соответствующих фильтрам.

Требуемый диапазон: x >= 0
next
string<uri> | null
обязательно

Абсолютный URL следующей страницы или null на последней странице.

previous
string<uri> | null
обязательно

Абсолютный URL предыдущей страницы или null на первой странице.

results
object[]
обязательно
Последнее изменение 7 ноября 2026 г.