Skip to main content

Заголовки запроса

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 — очередные автосписания по рассрочке / подписке.
Поиск (по пользователю/идентификаторам). Максимум 50 символов, пробелы по краям обрезаются.
object
Диапазон дат создания счёта.
object
Диапазон итоговой суммы счёта. Должно быть задано хотя бы одно из полей.
object
Фильтр по UTM-меткам счёта.
object
Фильтр по связанному платежу.

Поля ответа

object
Постраничный список счетов (компактная проекция). Полная структура — invoice в справочнике payment.

Требования к правам доступа

Требуется аутентификация по токену и право «Продажи школы» (SellerSales).

Обновлено: 2026-09-25 13:43 UTC