Запросить сведения о бенефициарe

Обновлено 4 сентября 2025

Скачать спецификацию

GET

/beneficiaries/details/{id}

Возвращает текущий статус и реквизиты бенефициара, хранимые в реестре
Чтобы использовать метод, в параметре scope ссылки авторизации пользователя должен быть указан сервис nominal_accounts для получения доступа к этому ресурсу

События по бенефициару:

• включить бенефициара в реестр;
• изменить информацию по бенефициару;
• удалить бенефициара из реестра;
• заблокировать/разблокировать бенефициара (события, инициируемые банком);

Сочетания типа события (eventType) и статуса события (eventValue):

• CREATE (создать бенефициара) - CREATED (Создан)
• PENDING (В процессе), ACTIVATED (Активирован), ERROR (Ошибка)
• UPDATE(изменить бенефициара) - CREATED (Создан), PENDING (В процессе), DONE (Исполнен), ERROR (Ошибка)
• DELETE (удалить бенефициара) - CREATED (Создан), PENDING (В процессе), DELETED (Удален), ERROR (Ошибка)'

Запрос

Ответы

• 200
• 400
• 401
• 403
• 404
• 405
• 422
• 429
• 500
• 502
• 503
• 504

OK

Response Headers

page-number

Порядковый номер страницы реестра бенефициаров

page-size

Количество элементов реестра бенефициаров на одной странице

total-elements

Общее количество элементов реестра бенефициаров

updated

Время обновления списка

Bad Request

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Unauthorized

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Forbidden

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Not Found

Method Not Allowed

Unprocessable Entity

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Too Many Requests

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Internal Server Error

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Bad Gateway

Response Headers

X-Request-Id

Уникальный идентификатор запроса.

Service Unavailable

Gateway Timeout

Loading...