> For the complete documentation index, see [llms.txt](https://docs.bitsby.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bitsby.app/ru/dokumentaciya-api/spisok-schetov.md).

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

## Запрос

```bash
curl -X POST https://api.bitsby.app/invoices/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "startDate=2000-01-01" \
	-F "endDate=2030-01-01" \
	-F "offset=0" \
	-F "limit=10"
```

## Параметры запроса

<table data-full-width="true"><thead><tr><th>Параметр</th><th>Тип данных</th><th>Описание</th><th>Пример</th><th>По умолчанию</th></tr></thead><tbody><tr><td><code>invoiceId</code></td><td>UUID</td><td>ID счета в формате UUID</td><td>1c48b092-9878-48f5-b441-07a8a48e7b54</td><td></td></tr><tr><td><code>invoiceUid</code></td><td>String</td><td>ID счета (для покупателя)</td><td>F7ncQviM1N92</td><td></td></tr><tr><td><code>projectId</code></td><td>UUID</td><td>ID проекта в формате UUID</td><td>1c48b092-9878-48f5-b441-07a8a48e7b54</td><td></td></tr><tr><td><code>startDate</code></td><td>String</td><td>Начальная дата создания счета в формате Y-m-d</td><td>2000-01-01</td><td></td></tr><tr><td><code>endDate</code></td><td>String</td><td>Конечная дата создания счета в формате Y-m-d</td><td>2030-01-01</td><td></td></tr><tr><td><code>status</code></td><td>String</td><td>Статус счета. Допустимые значения: unpaid, canceled, paid, expired</td><td>paid</td><td></td></tr><tr><td><code>offset</code></td><td>Integer</td><td>Номер начальной записи, с которой начнется вывод данных</td><td>0</td><td>0</td></tr><tr><td><code>limit</code></td><td>Integer</td><td>Количество записей, которые вы хотите получить</td><td>50</td><td>10</td></tr></tbody></table>

## Пример ответа

```json
{
    "result": "success",
    "data": [
        {
            "id": "59302b02-d1be-4e10-960f-d6ec24bfcaaf",
            "uid": "F7nYgvxM1N92",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime": "2024-02-29 10:49:56",
            "timeToPayDatetime": "2024-03-01 10:49:56",
            "commissionFiatUSD": "1.00",
            "amountFiatUSD": "100.00",
            "amountFiat": "100.00",
            "currencyFiat": "USD",
            "description": null,
            "serviceData": null,
            "views": 0,
            "status": "canceled"
        },
        {
            "id": "f31c61f6-407f-4999-95cf-56477eff06d4",
            "uid": "riUZBnNvd2rX",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime": "2024-02-27 20:57:23",
            "timeToPayDatetime": "2024-02-28 08:57:23",
            "commissionFiatUSD": "0.12",
            "amountFiatUSD": "12.00",
            "amountFiat": "12.00",
            "currencyFiat": "USD",
            "description": null,
            "serviceData": "userId:2444",
            "views": 0,
            "status": "paid",
            "payment": {
                "id": "f986ad8d-2298-473d-982a-efbc817b975d",
                "amount": "12.00000000",
                "hash": "f09352627039c088688806821b864895ff237558612d834861621fc026de5f68",
                "transactionDatetime": "2024-02-27 21:05:36"
            },
            "wallet": {
                "id": "47aa71e2-07a0-482e-9172-7114d7376ba0",
                "name": "usdt-tron",
                "blockchain": "tron",
                "cryptocurrency": "usdt",
                "address": "TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
            }
        }
    ]
}
```

## Параметры ответа

<table data-full-width="false"><thead><tr><th width="272">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td><code>id</code></td><td>ID счета в формате UUID</td></tr><tr><td><code>uid</code></td><td>ID счета (для покупателя)</td></tr><tr><td><code>projectId</code></td><td>ID проекта в формате UUID</td></tr><tr><td><code>createDatetime</code></td><td>Дата и время создания счета (UTC)</td></tr><tr><td><code>timeToPayDatetime</code></td><td>Дата и время, до которого действителен счет (UTC). До этой даты покупатель должен успеть оплатить счет</td></tr><tr><td><code>commissionFiatUSD</code></td><td>Сумма комиссии сервиса. Рассчитывается относительно суммы <code>invoice.amountFiatUSD</code></td></tr><tr><td><code>amountFiatUSD</code></td><td>Сумма в валюте USD, рассчитанная при создании счета по текущему курсу относительно суммы <code>invoice.amountFiat</code></td></tr><tr><td><code>amountFiat</code></td><td>Сумма в фиатной валюте</td></tr><tr><td><code>currencyFiat</code></td><td>Валюта фиата</td></tr><tr><td><code>description</code></td><td>Описание, которое было задано при создании счета. Отображается покупателю</td></tr><tr><td><code>serviceData</code></td><td>Служебные данные, которые были заданы через API при создании счета. Не отображается покупателю. Служит для идентификации счета и платежа в магазине продавца</td></tr><tr><td><code>views</code></td><td>Количество просмотров платежной страницы</td></tr><tr><td><code>status</code></td><td>Статус счета</td></tr><tr><td><code>payment</code></td><td>Раздел, содержащий параметры платежа. Отображается в случае, если счет был оплачен</td></tr><tr><td><code>payment.id</code></td><td>ID платежа в формате UUID</td></tr><tr><td><code>payment.amount</code></td><td>Сумма платежа в криптовалюте</td></tr><tr><td><code>payment.hash</code></td><td>Хэш транзакции в блокчейне</td></tr><tr><td><code>payment.transactionDatetime</code></td><td>Дата и время транзакции в блокчейне (UTC)</td></tr><tr><td><code>wallet</code></td><td>Раздел, содержащий параметры кошелька, на который пришла оплата. Отображается в случае, если счет был оплачен</td></tr><tr><td><code>wallet.id</code></td><td>ID кошелька в формате UUID</td></tr><tr><td><code>wallet.name</code></td><td>Название кошелька</td></tr><tr><td><code>wallet.blockchain</code></td><td>Блокчейн крипто кошелька</td></tr><tr><td><code>wallet.cryptocurrency</code></td><td>Криптовалюта кошелька</td></tr><tr><td><code>wallet.address</code></td><td>Адрес крипто кошелька</td></tr></tbody></table>