# Счета

# Список

Для получения списка счетов используется запрос **bill/list**:

```javascript
POST https://api.novaconnect.kz/api/bill/list

{
  "page": <int>,
  "size": <int>,
}
```
##### Параметры
| Параметр | Тип | Описание | Обязательность |
|-------|----------|---------|---------|
| **page**     | int     | Номер страницы, нумерация с 0     |Нет
| **size**    | int      | Размер страницы      |Нет

#### Успешный ответ
```javascript
{
  "code": 200,
  "count": <int>,
  "all_count": <int>,
  "items": [
    {
      ... объект типа счет
    }
  ],
  "message": <string>,
  "allow_operations": <object>
}
```

| Параметр | Тип | Описание |
|-------|----------|---------|
| **code**     | int     | Код ответа, для успеха - 200
| **message**    | string      | Сообщение ответа
| **count**    | int      | Количество данных в ответе
| **all_count**    | int      | Количество данных в БД
|  **items**    | array      | Массив элементов ["Счет"](https://kb.novaconnect.kz/books/rukovodstvo-razrabotcika/page/scet)
| **allow_operations**    | object      | Не используется

# Файлы счёта и расшифровки

##### Счёт

Для получения файла счета, необходимо выполнить GET-запрос формата:

`https://api.novaconnect.kz/api/bill/download/<strong>id_счёта</strong>`

Токен можно передать:

- В заголовке **Authorization: Bearer &lt;token&gt;;**
- Либо в GET-параметре **token,** например *https://api.novaconnect.kz/api/bill/download/id\_счёта?**token=&lt;token&gt;***

<p class="callout info">Файл счёта возвращается в формате PDF</p>

##### Расшифровка счёта

Для получения файла расшифровки счета, необходимо выполнить GET-запрос формата:

`https://api.novaconnect.kz/api/bill/download/<strong>id_счёта?mode=transcript</strong>`

Токен передается в запросе аналогично получению счёта.

<p class="callout info">Файл расшифровки возвращается в формате XLSX</p>