Skip to main content

Получить выписку по счёту

GET

https://business.tinkoff.ru/openapi/api/v1/statement

Метод для получения списка операций по счёту за определённый период по указанным критериям поиска. Данные доступны с июня 2023 года.

Поля с датой и временем в запросе и ответе передаются в формате ISO 8601 по UTC.

Операции получаются порциями. Максимальный размер порции регулируется параметром limit. Если в текущем запросе не удаётся вернуть все операции, в ответе будет заполнено поле nextCursor с указателем на последнюю операцию в ответе. Чтобы получить очередную порцию операций, повторите запрос — в поле cursor укажите значение, полученное из nextCursor.

Чтобы в ответе вернулись балансы, передайте параметр withBalances со значением true. Они вернутся только для первого запроса — для следующих запросов очередной порции операций при заполнении поля cursor балансы не возвращаются.

Подробнее про сценарий Операции по счёту

Чтобы оперативно отслеживать статус оплаты, вы также можете воспользоваться вебхуком Операция по счёту.

Авторизация

Security

Bearer API Token

RPS

Ограничение 20 запросов в 1 секунду

Счета и выпискиИнформация об операциях компании с инн {inn} и кпп {kpp}

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Query parameters

Required

accountNumber

String

Requirements: Value must match regular expression ^(\d{20})$

Номер счёта.

categories

Array

Requirements: <= 50

Категории операций.

cursor

String

Requirements: <= 100 characters

Указатель на последнюю операцию, полученную в предыдущем запросе.

Required

from

String<date-time>

Дата начала периода, включительно.

inns

Array

Requirements: <= 50

ИНН контрагентов.

limit

Integer<int32>

Requirements: >= 1 and <= 5000

Максимальное количество операций, которое нужно получить за один вызов метода.

operationStatus

String

Requirements: [All, Authorization, Transaction]

Статус операции для фильтрации: все операции, только авторизации или только подтвержденные транзакции.

to

String<date-time>

Дата окончания периода, не включительно.

ucid

Integer<int64>

UCID карты.

withBalances

Boolean

Если передан true, возвращаются балансы.

Ответ

200

Список операций

400

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

401

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

403

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

422

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

429

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

500

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

Loading...

openapi@tinkoff.ru

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.