# Статистика по счетам

## Описание

Позволяет получить общую статистику по вашим счетам и платежам.

## Запрос

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

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

<table data-full-width="true"><thead><tr><th>Параметр</th><th>Тип данных</th><th>Описание</th><th>Пример</th><th>Обязательный?</th></tr></thead><tbody><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></tbody></table>

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

```json
{
    "result": "success",
    "data": {
        "invoicesTotalNum": 51,
        "invoicesPaidNum": 24,
        "invoicesTotalUSD": 335.03,
        "invoicesByProjects": {
            "9deea1e2-0c08-41a3-bdc2-a34eada3892d": 335.03
        },
        "invoicesByCurrencies": {
            "USD": 335.03
        },
        "invoicesByMonths": {
            "March-2024": 42,
            "February-2024": 293.03
        },
        "invoicesByDate": {
            "2024-03-04": {
                "date": 1709510400000,
                "value": 21
            },
            "2024-03-03": {
                "date": 1709424000000,
                "value": 10
            },
            "2024-03-01": {
                "date": 1709251200000,
                "value": 11
            },
            "2024-02-27": {
                "date": 1708992000000,
                "value": 12
            },
            "2024-02-26": {
                "date": 1708905600000,
                "value": 38
            }
        }
    }
}
```

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

| Параметр               | Описание                                              |
| ---------------------- | ----------------------------------------------------- |
| `invoicesTotalNum`     | Общее количество счетов                               |
| `invoicesPaidNum`      | Количество оплаченных счетов (со статусом “Оплачен”)  |
| `invoicesTotalUSD`     | Сумма всех оплаченных счетов в USD                    |
| `invoicesByProjects`   | Сумма всех оплаченных счетов по проектам в USD        |
| `invoicesByCurrencies` | Сумма всех оплаченных счетов по валютам               |
| `invoicesByMonths`     | Сумма всех оплаченных счетов по месяцам в USD         |
| `invoicesByDate`       | Сумма всех оплаченных счетов по дням в USD            |
| `invoicesByDate.date`  | Дата в формате Unix Timestamp c учетом микросекунд    |
| `invoicesByDate.value` | Сумма всех оплаченных счетов на конкретную дату в USD |


---

# 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/statistika-po-schetam.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.