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

## Описание

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

## Запрос

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