# بیلنس کی ہسٹری

## درخواست

```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`   | ایونٹ پر تبصرہ                                                                                           |