Перейти к основному содержанию
POST
Python

Авторизации

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.

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

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

UUID сессии Верификации бизнеса (KYB). Он должен принадлежать приложению используемого API-ключа.

Пример:

"33333333-4444-5555-6666-777777777777"

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

node_id
string

Узел сценария для шага KYB. Требуется, только если в сценарии несколько KYB-узлов; по умолчанию Didit использует собственный узел сессии.

Тело

application/json
locale
string

Локаль (locale), используемая для перевода ответа шага, к которому переходит сессия.

Maximum string length: 10

Ответ

Стороны, заявленные (или уже заявленные).

valid
boolean
next_step
string | null

Шаг, на котором находится сессия.

status
string

Статус сессии компании.

advanced
boolean

true, если этот вызов объявил стороны и перевёл сессию на следующий этап.

already_submitted
boolean

true, если стороны были объявлены ранее в рамках другого вызова.

kyb_key_people_status
string
parties
object[]
Последнее изменение 7 ноября 2026 г.