Начало работы
Интеграция / SDK
Проверка пользователей
Верификация бизнеса
Мониторинг транзакций
Журнал измененийcurl -s 'https://verification.didit.me/v3/sessions/?status=Approved,In%20Review&date_from=2026-06-01&limit=20' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.sessions.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.sessions.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Sessions.ListAutoPaging(ctx, didit.SessionsListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.sessions().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->sessions->list() as $item) {
print_r($item);
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.sessions.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Sessions.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
"session_kind": "user",
"session_number": 720,
"session_url": "https://verify.didit.me/session/CuXoBYCYVO5Y",
"portrait_image": "https://<media-host>/portraits/5b3720ed.jpg?X-Amz-Expires=3600&X-Amz-Signature=...",
"document_type": "Passport",
"full_name": "Jane Marie Doe",
"country": "ESP",
"status": "Approved",
"vendor_data": "your-user-id-123",
"didit_internal_id": "d9e78474-6c8d-4f2a-bb90-6f5c2f3a1147",
"created_at": "2026-06-09T12:26:54.328364Z",
"features": [
{
"feature": "ID_VERIFICATION",
"status": "Approved"
},
{
"feature": "LIVENESS",
"status": "Approved"
},
{
"feature": "FACE_MATCH",
"status": "Approved"
},
{
"feature": "AML",
"status": "Approved"
},
{
"feature": "IP_ANALYSIS",
"status": "Approved"
}
],
"phone_number": {
"number": "+14155552671",
"is_verified": true
},
"email_address": {
"email": "jane@example.com",
"is_verified": true
},
"additional_details": {
"aml": {
"total_hits": 0,
"entity_type": "person",
"is_adverse_media_fetched": false
},
"liveness": {
"method": "PASSIVE",
"score": 0.98
},
"face_match": {
"score": 0.95
}
}
},
{
"session_id": "038ad62f-5ebd-46c2-afe9-4b2956bf687f",
"session_kind": "user",
"session_number": 719,
"session_url": "https://verify.didit.me/session/7RGKiO6ioGH6",
"portrait_image": null,
"document_type": null,
"full_name": null,
"country": null,
"status": "Not Started",
"vendor_data": "your-user-id-124",
"didit_internal_id": "eb4e679d-ca4b-461f-9685-687bac29ebdb",
"created_at": "2026-06-09T08:02:23.343053Z",
"features": [
{
"feature": "ID_VERIFICATION",
"status": "Not Finished"
},
{
"feature": "LIVENESS",
"status": "Not Finished"
},
{
"feature": "FACE_MATCH",
"status": "Not Finished"
},
{
"feature": "AML",
"status": "Not Finished"
},
{
"feature": "IP_ANALYSIS",
"status": "Not Finished"
}
],
"phone_number": null,
"email_address": null,
"additional_details": null
}
]
}Список сессий API: фильтр сессий KYC и KYB
GET /v3/sessions/ выводит сессии верификации с фильтрами по типу, статусу, сценарию и данным поставщика. Единый API KYC и KYB от Didit, оплата за использование.
curl -s 'https://verification.didit.me/v3/sessions/?status=Approved,In%20Review&date_from=2026-06-01&limit=20' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.sessions.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.sessions.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Sessions.ListAutoPaging(ctx, didit.SessionsListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.sessions().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->sessions->list() as $item) {
print_r($item);
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.sessions.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Sessions.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
"session_kind": "user",
"session_number": 720,
"session_url": "https://verify.didit.me/session/CuXoBYCYVO5Y",
"portrait_image": "https://<media-host>/portraits/5b3720ed.jpg?X-Amz-Expires=3600&X-Amz-Signature=...",
"document_type": "Passport",
"full_name": "Jane Marie Doe",
"country": "ESP",
"status": "Approved",
"vendor_data": "your-user-id-123",
"didit_internal_id": "d9e78474-6c8d-4f2a-bb90-6f5c2f3a1147",
"created_at": "2026-06-09T12:26:54.328364Z",
"features": [
{
"feature": "ID_VERIFICATION",
"status": "Approved"
},
{
"feature": "LIVENESS",
"status": "Approved"
},
{
"feature": "FACE_MATCH",
"status": "Approved"
},
{
"feature": "AML",
"status": "Approved"
},
{
"feature": "IP_ANALYSIS",
"status": "Approved"
}
],
"phone_number": {
"number": "+14155552671",
"is_verified": true
},
"email_address": {
"email": "jane@example.com",
"is_verified": true
},
"additional_details": {
"aml": {
"total_hits": 0,
"entity_type": "person",
"is_adverse_media_fetched": false
},
"liveness": {
"method": "PASSIVE",
"score": 0.98
},
"face_match": {
"score": 0.95
}
}
},
{
"session_id": "038ad62f-5ebd-46c2-afe9-4b2956bf687f",
"session_kind": "user",
"session_number": 719,
"session_url": "https://verify.didit.me/session/7RGKiO6ioGH6",
"portrait_image": null,
"document_type": null,
"full_name": null,
"country": null,
"status": "Not Started",
"vendor_data": "your-user-id-124",
"didit_internal_id": "eb4e679d-ca4b-461f-9685-687bac29ebdb",
"created_at": "2026-06-09T08:02:23.343053Z",
"features": [
{
"feature": "ID_VERIFICATION",
"status": "Not Finished"
},
{
"feature": "LIVENESS",
"status": "Not Finished"
},
{
"feature": "FACE_MATCH",
"status": "Not Finished"
},
{
"feature": "AML",
"status": "Not Finished"
},
{
"feature": "IP_ANALYSIS",
"status": "Not Finished"
}
],
"phone_number": null,
"email_address": null,
"additional_details": null
}
]
}Фильтр по типу сессии
Используйте параметр запросаsession_kind, чтобы выбрать тип сессий для возврата:
| Значение | Возвращает |
|---|---|
user (по умолчанию) | Только сессии Проверки пользователей (KYC). Обратная совместимость: чтобы получить его, не указывайте session_kind. |
business | Только сессии Верификации бизнеса (KYB). |
all | Сессии Проверки пользователей и Верификации бизнеса, объединённые в один список. |
session_kind: "user" | "business", чтобы ваш клиент мог определять структуру каждой строки.
Общие фильтры
Эти фильтры применяются к обоим типам (фильтры только для пользователей игнорируются, когдаsession_kind=business, и наоборот):
| Параметр запроса | Описание |
|---|---|
session_kind | user, business или all. По умолчанию user. |
vendor_data | Точное совпадение с вашим идентификатором. |
status | Один или несколько статусов через запятую, написанных точно так, как их возвращает API: Approved, Declined, In Review и так далее (см. Статусы верификации). |
workflow_id | Фильтр по используемому сценарию. |
country | Фильтр по коду страны (для пользователей: issuing_states, для компаний: country_code). |
date_from, date_to | Временной интервал по дате создания (ISO 8601). |
tags | Идентификаторы тегов через запятую. Возвращает сессии, у которых есть любой из них. |
decided_from, decided_to | Даты и время в формате ISO 8601. Возвращает сессии, статус которых последний раз менялся в этом интервале (от значения включительно, до значения не включительно). Используется время последнего изменения статуса, а не время создания. |
search | Полный отображаемый номер, например S-0001 или B-0001, находит только эту сессию по номеру и типу, игнорируя ведущие нули и регистр букв. Любой другой ввод ищет по существующим полям имени, контакта, документа, регистрационного номера и vendor_data. |
Примеры
- Список сессий Проверки пользователей (KYC) (по умолчанию)
- Список сессий Верификации бизнеса (KYB)
- Список обоих типов
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: YOUR_API_KEY" \
--data-urlencode "vendor_data=user-42"
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"session_id": "...",
"session_kind": "user",
"session_number": 1024,
"session_url": "...",
"portrait_image": "...",
"document_type": "Passport",
"full_name": "John Doe",
"country": "GBR",
"status": "Approved",
"vendor_data": "user-42",
"didit_internal_id": "...",
"created_at": "2026-04-10T09:00:00Z",
"features": "ID_VERIFICATION,LIVENESS,FACE_MATCH,AML",
"phone_number": "+14155550123",
"email_address": "jane@example.com",
"additional_details": null
}
]
}
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: YOUR_API_KEY" \
--data-urlencode "session_kind=business" \
--data-urlencode "status=Approved"
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"session_id": "...",
"session_kind": "business",
"session_number": 89,
"status": "Approved",
"vendor_data": "biz-acme-001",
"created_at": "2026-04-01T09:00:00Z",
"workflow_id": "wf_kyb_standard",
"workflow_type": "business",
"workflow_label": "Standard KYB",
"company_name": "Acme Corporation Limited",
"registration_number": "12345678",
"country": "GBR"
}
]
}
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: YOUR_API_KEY" \
--data-urlencode "session_kind=all" \
--data-urlencode "date_from=2026-04-01T00:00:00Z"
results. Клиенту следует определять структуру каждой строки по session_kind.all объединяет результаты, а не чередует их по временной метке. Для больших объёмов смешанных выборок запрашивайте каждый тип отдельно и объединяйте результаты на стороне клиента.Структура строк зависит от типа
Строки Проверки пользователей (KYC) включают:portrait_image, document_type, full_name, country (страна выдачи), phone_number, email_address и несколько полей проверки: assignee (проверяющий в Консоли, который ведёт сессию, или null), waiting_since и sla_due_at (задаются только пока сессия находится в статусе In Review), top_warnings (наиболее важные предупреждения, каждое с risk, feature, log_type и short_description) и warnings_count.
Строки Верификации бизнеса (KYB) включают: workflow_type, workflow_label, company_name, registration_number, country (страна регистрации).
Оба типа содержат: session_id, session_kind, session_number, status, vendor_data, created_at.
Полную матрицу функций см. в разделе Обзор сессий.
Пагинация
Пагинация используетlimit (по умолчанию 50) и offset (по умолчанию 0), а в ответе есть абсолютные URL next и previous. Оба параметра принимают значения до 1000000; большее значение возвращает 400.
count точен до 100 и остаётся равным 100 при большем количестве, поэтому не используйте его как общее число. Продолжайте запрашивать URL next, пока он не станет null. При session_kind=all значение count равно сумме обоих типов, каждый из которых ограничен 100.
Связанные материалы
- Обзор сессий
- Получение сессии — полное решение по одной строке
- Обзор компаний — сущность Business, агрегированная по сессиям
- Обзор пользователей — сущность User, агрегированная по сессиям
Авторизации
API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.
Параметры запроса
Какой тип сессий возвращать в списке: user (только KYC, по умолчанию), business (только KYB) или all (оба типа, объединённые - семантику объединённой пагинации см. в описании). Сопоставление нечувствительно к регистру (работает BUSINESS); любое значение, отличное от вариантов регистра user/business/all, возвращает 400.
user, business, all Максимальное количество строк на странице (для каждого типа при session_kind=all). По умолчанию 50.
1 <= x <= 1000000Количество строк, пропускаемых перед первой возвращаемой строкой. По умолчанию 0. Рекомендуется переходить по URL next/previous из ответа.
0 <= x <= 1000000Разделённый запятыми список статусов сессий для включения, например Approved,In Review. Значения чувствительны к регистру; см. Статусы верификации. Неизвестные значения не дают совпадений.
Фильтр по точному совпадению с vendor_data, переданным при создании сессии (ваш собственный идентификатор пользователя/компании). Для частичных совпадений используйте search.
Полная отображаемая ссылка, например S-0001 (пользователь) или B-0001 (компания), соответствует только сессии с этим номером и типом; ведущие нули и регистр букв не влияют на сопоставление. Интеллектуальный поиск по свободному тексту. Полный UUID сопоставляется с session_id; числовой ввод сопоставляется с префиксом номера сессии, номерами документов/персональными номерами, префиксом телефона или vendor_data; ввод, содержащий @, сопоставляется с префиксами email; прочий текст сопоставляется с именами (без учёта диакритики) и vendor_data. Свободный текст, содержащий цифры, дополнительно сопоставляется с полями поиска документов/персональных номеров и префиксами номеров сессий.
Разделённые запятыми UUID сценариев (их можно найти на странице Workflows в Console). Некорректные UUID в списке игнорируются; если валидных нет, результат будет пустым.
Только сессии, созданные в эту дату (UTC) или позже, формат YYYY-MM-DD. Некорректный формат даты возвращает ошибку 400.
Только сессии, созданные до этой даты (UTC) включительно, формат YYYY-MM-DD. Для строк KYC включается весь день; для строк KYB сравнение выполняется как created_at <= date_to (полночь), поэтому используйте дату следующего дня, чтобы включить полный день сессий KYB.
Разделённый запятыми список идентификаторов тегов (tags вашего приложения). Возвращает сессии, содержащие любой из них. Идентификаторы, не являющиеся корректными UUID, игнорируются, и если ни один из них не валиден, список будет пустым.
Дата и время в формате ISO 8601. Возвращает сессии, статус которых в последний раз изменился в этот момент или позже. Фильтрация выполняется по времени последнего изменения статуса, а не по времени создания.
Дата и время в формате ISO 8601. Возвращает сессии, статус которых в последний раз изменился до этого момента. Объедините с decided_from для задания полуинтервала.
Разделённый запятыми фильтр по странам. Для строк KYC: трёхбуквенные коды ISO 3166-1 alpha-3 страны выдачи документа, удостоверяющего личность (например, ESP,USA), которая может отличаться от гражданства. Для строк KYB: код страны компании из реестра.
Разделённые запятыми коды типов документов, удостоверяющих личность, проверенных в сессии (только строки KYC): P (Паспорт), ID (Удостоверение личности), DL (Водительское удостоверение), RP (Вид на жительство), SSC (Карта социального страхования), HIC (Медицинская страховая карта), WP (Разрешение на работу), TC (Налоговая карта), VISA, PSC (Карта государственного обслуживания), BC (Свидетельство о рождении), OTHER. Обратите внимание, что поле ответа document_type содержит отображаемое имя, а не код.
Точные названия документов; несколько названий можно передать через запятую, однако разделение по запятым выполняется только при наличии более одного разделителя - (отдельное название со встроенной запятой сопоставляется целиком). Названия указываются так, как они распознаются при верификации документов (лицевая или оборотная сторона), например Spain - Id Card (2021). Только для строк KYC.
Разделённые запятыми значения региона/штата документа (для документов, выдаваемых по регионам, таких как водительские удостоверения в США). Только для строк KYC.
Фильтр по внутреннему идентификатору пользователя в Didit (поле ответа didit_internal_id) для вывода всех сессий одного верифицированного пользователя. Должен быть корректным UUID; некорректные значения возвращают 400. Только для записей KYC.
Разделённый запятыми список каналов создания сессий: API, HOSTED, MIGRATED. Специальное значение ALL (или отсутствие параметра) отключает фильтр. Только строки KYC.
Фильтр автономных сессий API по сервису. Недопустимые значения возвращают 400. Только строки KYC.
ID_VERIFICATION, FACE_MATCH, AGE_ESTIMATION, FACE_SEARCH, POA, AML, KYB_REGISTRY, PASSIVE_LIVENESS, DATABASE_VALIDATION, PHONE_VERIFICATION, EMAIL_VERIFICATION Поиск по имени без учёта диакритических знаков среди данных, проверенных в рамках AML и проверки по базам данных. В сочетании с api_service=AML или api_service=DATABASE_VALIDATION поиск ограничивается проверенными данными соответствующей функции. Только строки KYC.
Разделённые запятыми коды риска предупреждений; возвращает сессии, для которых сработал любой из них (например, POSSIBLE_FRAUD). Коды риска перечислены для каждой функции в документации по предупреждениям. Применяется к строкам KYC и, с кодами предупреждений для бизнеса, к строкам KYB.
Когда true, возвращает только сессии, решение по которым изначально перешло в статус In Review (полезно для аудита объема ручных проверок). Только строки KYC.
true возвращает сессии, верификация документов которых помечена для ручной проверки; false возвращает сессии, где верификация документов явно не помечена. Опустите, чтобы отключить фильтр. Только для строк KYC.
Фильтр по euuid конечного пользователя (UUID, назначенный верифицируемому пользователю; используется диплинками Console). Должен быть валидным UUID; некорректные значения возвращают ошибку поля с кодом 400. Только строки KYC.
Разделённый запятыми список названий организаций. Предназначен для Console; при использовании API-ключа (уже привязанного к одному приложению) соответствует только названию вашей собственной организации.
Ответ
Список сессий с пагинацией. Элементы results представляют собой строки KYC, строки KYB или и то, и другое в зависимости от session_kind; различайте их с помощью поля session_kind каждой строки.
Количество сессий, соответствующих фильтрам: точное значение до 100 и с ограничением 100 сверх этого порога, поэтому не используйте его в качестве общего итога. Используйте next, чтобы узнать, есть ли ещё страницы. Для session_kind=all это сумма обоих типов, каждый с ограничением 100.
2
Абсолютный URL следующей страницы или null на последней странице.
"https://verification.didit.me/v3/sessions/?limit=20&offset=20"
Абсолютный URL предыдущей страницы или null на первой странице.
null
Строки сессий, сначала новые. При session_kind=all сначала идут строки KYC, затем строки KYB.
Сводная строка для сессии Проверки пользователей (KYC). Поля личности (full_name, country, document_type, portrait_image, контактные поля) заполняются по мере прохождения пользователем шагов верификации и имеют значение null, пока соответствующий шаг не завершён. Поля, ограниченные настройкой атрибутов ответа сценария, также возвращаются как null.
- KYC session row (session_kind: user)
- KYB session row (session_kind: business)
Show child attributes
Show child attributes