Получить налоговый баланс самозанятого

GET

https://secured-openapi.tbank.ru/api/v1/self-employed/taxpayers/{inn}/account-balance

Метод возвращает текущий налоговый баланс самозанятого.

Запрос можно отправить только в ночное время — с 22:00 до 06:00 мск. Это связано с ограничениями от ФНС. Если отправить запрос в другое время, вернётся ошибка с кодом OPERATION_REJECTED.

Авторизация

Security

Bearer API Token

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

RPS

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

Scopes

Самозанятые → Получение налогового баланса самозанятого

Header parameters

X-Request-Id

String<uuid>

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

Path parameters

Required

inn

String

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

ИНН.

Ответ

200

400

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

401

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

403

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

422

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

429

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

500

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

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

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

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