Получить всех депонентов этапа

/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/deponents

GET

https://secured-openapi.tbank.ru/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/deponents

Позволяет получить всех депонентов этапа сделки.

Ограничение на использование метода — 10 запросов в секунду.

Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage — Управление номинальными счетами.

Авторизация

Security

Bearer API Token

MTLS-сертификат

Path parameters

Required

dealId

String<uuid>

Идентификатор сделки.

Required

stepId

String<uuid>

Идентификатор этапа сделки.

Query parameters

offset

Integer<int32>

Количество депонентов, которое нужно пропустить. Значение по умолчанию — 0.

limit

Integer<int32>

Количество депонентов, которое нужно вывести. Значение по умолчанию — 50.

Ответ

200

OK

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции

Пример запроса

cURL

Go

Java

NodeJs

PHP

Python

Content type

curl --location 'https://secured-openapi.tbank.ru/api/v1/nominal-accounts/deals/:dealId/steps/:stepId/deponents' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <TOKEN>'\
--cert /path/to/cert.pem \
--key /path/to/key.key

Пример ответа

200

400

401

403

422

429

500

Content type

application/json

{

"offset":

0,

"limit":

50,

"size":

1,

"total":

1,

"results": [

{ ... }

"dealId":

"dd6c3237-9958-47d9-9ba0-f6faeaa0e788",

"stepId":

"c87d3297-f4ae-4f88-add9-6722c1fc0b8c",

"beneficiaryId":

"61f656e0-0a86-4ec2-bd43-232499f7ad66",

"amount":

100

}

]

}