# Historial del saldo

## Solicitud

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

## Parámetros de la solicitud

| Parámetro | Tipo de dato | Descripción                             | Ejemplo | ¿Obligatorio? | Por defecto |
| --------- | ------------ | --------------------------------------- | ------- | ------------- | ----------- |
| `offset`  | Integer      | Índice del primer registro a devolver   | 0       | no            | 0           |
| `limit`   | Integer      | Número de registros que quieres recibir | 50      | no            | 10          |

## Ejemplo de respuesta

```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)"
        }
    ]
}
```

## Parámetros de la respuesta

| Parámetro   | Descripción                                                                                              |
| ----------- | -------------------------------------------------------------------------------------------------------- |
| `datetime`  | Fecha y hora del evento                                                                                  |
| `event`     | Tipo de evento. Valores permitidos: deposit, withdrawal, transfer, commission, aml, other                |
| `projectId` | ID del proyecto al que pertenece la operación. Para las operaciones a nivel de cuenta —recargas y bonos— es null |
| `target`    | El saldo que cambió. Valores permitidos: internal, partner                                               |
| `amount`    | El importe en que cambió el saldo                                                                        |
| `comment`   | Comentario del evento                                                                                    |