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

Обзор

Удаляет одну или несколько сущностей компаний. Записи компаний удаляются безвозвратно. Сессии верификации бизнеса (KYB) этот endpoint не затрагивает: они сохраняются, а их связь с компанией очищается. Удалите их с помощью Удаление сессии. Транзакции тоже не затрагиваются; удалите их с помощью Пакетное удаление транзакций.

Когда использовать

  • Запросы на право на забвение.
  • Очистка тестовых компаний во время QA.
  • Деактивация компаний, удалённых с вашей платформы.

Примечания

  • Принимает список значений vendor_data или didit_internal_id.
  • Идемпотентно: удаление уже удалённой компании ничего не меняет.
  • Возвращает только количество удалённых записей, а не отчёт по каждому элементу. Значения, которым ничего не соответствует, пропускаются без уведомления.
  • Отправляет событие business.data.updated с заполненным deleted_at.
  • Записи, принадлежащие самой компании, удаляются вместе с ней: её связи с тегами, история комментариев и её собственные записи об устройствах и сети.
  • Записи, созданные сессией KYB, НЕ удаляются: данные реестра компаний, загруженные документы, срабатывания AML-проверки, бенефициарные владельцы и проверки ключевых лиц принадлежат сессии и сохраняются, пока вы не удалите саму сессию.

Данные в завершённом регуляторном отчёте

Если какая-либо из выбранных компаний входит в кейс с завершённым регуляторным отчётом, весь запрос возвращает 409, и ничего не удаляется. В ответе используется code: in_filed_report, и перечислен каждый отчёт:
Удалите каждый отчёт с помощью Удаление отчёта, затем повторите тот же запрос.

Удаление, которое уже выполняется

Компания удаляется одним запросом за раз. Если другой запрос ещё удаляет одну из выбранных компаний, этот запрос ждёт не более нескольких секунд, затем возвращает 409 с code: subject_deletion_in_progress и ничего не удаляет:
Повторите тот же запрос после завершения другого удаления. Компания, которую первый запрос уже удалил, больше не соответствует условиям, поэтому повтор удалит только оставшиеся компании.

Разрешения

Роль должна предоставлять delete:businesses. Как правило, это право предоставляется ролям OWNER и ADMIN.

Связанные материалы

Авторизации

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.

Тело

application/json

Укажите vendor_data_list, didit_internal_id_list или delete_all: true. Приоритет при отправке нескольких параметров: delete_all > vendor_data_list > didit_internal_id_list (используется только селектор с наивысшим приоритетом).

vendor_data_list
string[]

Ваши собственные идентификаторы для удаления, сопоставляемые в точности с переданными.

didit_internal_id_list
string<uuid>[]

Внутренние UUID Didit (didit_internal_id) для удаления.

delete_all
boolean
по умолчанию:false

Если true, удаляет все компании в приложении. Не может сочетаться с селекторами списка.

Ответ

Компании удалены. Возвращает количество фактически удалённых строк.

deleted
integer

Количество удалённых компаний (исключает значения vendor_data, для которых ничего не найдено).

Последнее изменение 7 ноября 2026 г.