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

## Запрос

```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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bitsby.app/ru/dokumentaciya-api/spisok-schetov.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.