Перейти к содержимому

Список счетов

GET
/invoices
curl --request GET \
--url 'https://app.mybi.ru/api/v2/invoices?page=1&length=10&id=1%2C2%2C3&created_from=2026-01-01%2000%3A00%3A00&created_to=2026-01-01%2023%3A59%3A59&modified_from=2026-01-01%2000%3A00%3A00&modified_to=2026-01-01%2023%3A59%3A59&token=<token>'

Возвращает список счетов на оплату. Результат разбит на страницы (поле pagination), доступны фильтры по идентификаторам и датам.

page
integer
по умолчанию: 1 >= 1

Текущая страница

Пример

1
length
integer
по умолчанию: 100 >= 1 <= 500

Количество записей на странице

Пример

10
id
Array<integer>
>= 1 элементов <= 500 элементов уникальные элементы

Идентификаторы записей через запятую, не более 500

Пример

?id=1%2C2%2C3
created_from
string
/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/

Дата создания с, формат YYYY-MM-DD HH:MM:SS

Пример

2026-01-01 00:00:00
created_to
string
/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/

Дата создания по, формат YYYY-MM-DD HH:MM:SS

Пример

2026-01-01 23:59:59
modified_from
string
/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/

Дата изменения с, формат YYYY-MM-DD HH:MM:SS

Пример

2026-01-01 00:00:00
modified_to
string
/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/

Дата изменения по, формат YYYY-MM-DD HH:MM:SS

Пример

2026-01-01 23:59:59

Список счетов успешно получен

MIME-типapplication/json
object
invoices

Список счетов

Array<object>

Счет

object
id

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

integer
customer

Клиент

object
name

Название

string
inn

ИНН

string
kpp

КПП

string
amount

Сумма

number формат: double
received

Получен

boolean
paid

Оплачен

boolean
url

Ссылка на оплату счета

string формат: uri
created_date

Дата создания

string формат: date-time
modified_date

Дата изменения

string формат: date-time
pagination

Параметры постраничной выдачи

object
page
обязательный

Номер текущей страницы (нумерация с 1)

integer
has_next

Есть ли следующая страница

boolean
has_prev

Есть ли предыдущая страница

boolean
fact_length

Сколько записей возвращено на этой странице

integer
length
обязательный

Запрошенный размер страницы

integer
total
обязательный

Всего записей по заданному фильтру

integer

Пример

{
"pagination": {
"page": 1,
"has_next": true,
"has_prev": true,
"fact_length": 10,
"length": 10,
"total": 5000
}
}

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

MIME-типapplication/json
object
status

Код ошибки

integer
error

Текст ошибки

string

Пример сгенерировано

{
"status": 1,
"error": "example"
}