Заголовки запроса
string
обязательно
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".Все параметры фильтрации необязательны. Параметры-массивы передаются повторением параметра в строке запроса:
userIds=1&userIds=2. Диапазоны (*Range) передаются как вложенные параметры, например
createdAtDateRange[from] и createdAtDateRange[to].Параметры запроса
Пагинация
integer
Количество записей, которые нужно пропустить. По умолчанию
0.integer
Номер страницы (альтернатива
skip). Начинается с 1.integer
Количество записей на странице. От
1 до 1000. По умолчанию 100.Фильтрация
integer[]
Фильтр по ID счетов.
integer[]
Фильтр по ID пользователей.
integer[]
Фильтр по ID продуктов.
enum[]
Фильтр по типу счёта:
Regular— разовая оплата;InstallmentInit/SubscriptionInit— оформление рассрочки / подписки (первый платёж и привязка карты);InstallmentPay/SubscriptionPay— очередные автосписания по рассрочке / подписке.
string
Поиск (по пользователю/идентификаторам). Максимум 50 символов, пробелы по краям обрезаются.
object
Диапазон дат создания счёта.
object
Диапазон итоговой суммы счёта. Должно быть задано хотя бы одно из полей.
object
Фильтр по UTM-меткам счёта.
object
Фильтр по связанному платежу.
Поля ответа
object
Постраничный список счетов (компактная проекция). Полная структура —
invoice в справочнике
payment.Требования к правам доступа
Требуется аутентификация по токену и право «Продажи школы» (
SellerSales).Обновлено: 2026-09-25 13:43 UTC