> ## Documentation Index
> Fetch the complete documentation index at: https://virtualsms.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactions

> Paginated history of deposits, charges, refunds, and credits.

`GET /api/v1/customer/transactions`

Returns a paginated list of account transactions: every balance movement.

```bash theme={null}
curl "https://virtualsms.io/api/v1/customer/transactions?limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

## Query parameters

| Name     | Default | Description                                                            |
| -------- | ------- | ---------------------------------------------------------------------- |
| `type`   | (all)   | Filter by transaction type (`deposit`, `purchase`, `refund`, `credit`) |
| `from`   | (none)  | ISO timestamp lower bound                                              |
| `to`     | (none)  | ISO timestamp upper bound                                              |
| `limit`  | 50      | Page size (max 100)                                                    |
| `offset` | 0       | Pagination offset                                                      |

## Response

```json theme={null}
{
  "count": 142,
  "limit": 20,
  "offset": 0,
  "transactions": [
    {
      "id": "txn_abc123",
      "amount": -0.50,
      "type": "purchase",
      "description": "Telegram / GB",
      "order_id": "550e8400-e29b-41d4-a716-446655440000",
      "balance_before": 26.00,
      "balance_after": 25.50,
      "created_at": "2026-04-29T11:32:14Z"
    },
    {
      "id": "txn_def456",
      "amount": 25.00,
      "type": "deposit",
      "description": "USDT TRC20",
      "balance_before": 1.00,
      "balance_after": 26.00,
      "created_at": "2026-04-28T09:14:02Z"
    }
  ]
}
```

## Notes

* Negative `amount` = balance decrease (purchases). Positive `amount` = balance increase (deposits, refunds, credits).
* `order_id` is set only on transactions tied to a specific order.
* `count` is the total matching transactions across all pages, not just this page.