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

# List transactions

> Top-ups, charges, refunds and adjustments.

Top-ups, charges, refunds and adjustments, newest first. Your credit balance and transactions are not affected by the order data cleanup.

## Query parameters

**limit** `integer` (default: 20)

1-100, default 20.

**cursor** `integer`

Pass the `next_cursor` of the previous page. An invalid cursor returns `400`.

## Response

`type` is one of `topup`, `charge`, `refund`, `adjustment`. Charges are negative numbers. `order_id` is nullable (top-ups have no order).

```bash curl theme={null}
curl "https://orders.balaipedia.com/v1/transactions?limit=20" \
  -H "Authorization: Bearer YOUR_KEY"
```

```json 200 OK theme={null}
{"object":"list","has_more":false,"next_cursor":null,"data":[
  {"id":581,"type":"charge","amount":-0.15,"balance_after":42.2,"currency":"USD","order_id":"BP-7K3M9QXA","created_at":"2026-11-12T03:10:00.000Z"}
]}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.