# История изменения балансов

## Запрос

```bash
curl -X POST https://api.bitsby.app/billing/history \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
  -F "offset=0" \
  -F "limit=10"
```

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

| Параметр | Тип данных | Описание                                                | Пример | Обязательный? | По умолчанию |
| -------- | ---------- | ------------------------------------------------------- | ------ | ------------- | ------------ |
| `offset` | Integer    | Номер начальной записи, с которой начнется вывод данных | 0      | нет           | 0            |
| `limit`  | Integer    | Количество записей, которые вы хотите получить          | 50     | нет           | 10           |

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

```json
{
    "result": "success",
    "data": [
        {
            "datetime": "2024-11-30 18:02:41",
            "event": "other",
            "projectId": null,
            "target": "internal",
            "amount": 5,
            "comment": "welcome bonus 5"
        },
        {
            "datetime": "2025-08-15 02:00:01",
            "event": "commission",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "target": "internal",
            "amount": -0.15,
            "comment": "Commission 14.08.2025 (Sample project)"
        }
    ]
}
```

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

| Параметр    | Описание                                                                                                  |
| ----------- | --------------------------------------------------------------------------------------------------------- |
| `datetime`  | Дата и время события                                                                                      |
| `event`     | Тип события. Допустимые значения: deposit, withdrawal, transfer, commission, aml, other                   |
| `projectId` | ID проекта, к которому относится операция. У операций уровня аккаунта — пополнений и бонусов — равен null |
| `target`    | Тип баланса, который был изменен. Допустимые значения: internal, partner                                  |
| `amount`    | Сумма, на которую был изменен баланс                                                                      |
| `comment`   | Комментарий события                                                                                       |