---
title: "List Balances Transactions"
method: GET
path: "/v1/balances/transactions"
tags: ["Balances"]
---

# List Balances Transactions

`GET /v1/balances/transactions`

Returns a list of transactions that have contributed to your account balance, including charges, fees, and other adjustments. You can filter the results by specifying a time range. If no time range is provided, or only the end date is specified, the response will include transactions from the past 30 days up to today or the specified end date.

## Query parameters

- `page_size` integer, required
- `page_number` integer, required
- `start_time` string
- `end_time` string
- `currency` string
- `transaction_type` 'ALL' | 'PAYIN' | 'DEPOSIT' | 'PAYOUT' | 'TRANSFER' | 'CONVERSION' | 'FEE' | 'REFUND' | 'ADJUSTMENT' | 'INVOICE'
- `transaction_status` 'ALL' | 'COMPLETED' | 'PENDING' | 'FAILED'

## Headers

- `x-on-behalf-of` string

## Response `200`

OK - Balances transactions returned successfully.

- object
  - `total_pages` integer — The total pages of available items.
  - `total_items` integer — The total counts of available items.
  - `data` object[]
    - `transaction_id` string, uuid, required — Unique Identifier for transaction
    - `account_id` string, required — The account id.
    - `balance_id` string, required — The account balance id.
    - `transaction_type` 'DEPOSIT' | 'PAYOUT' | 'TRANSFER' | 'CONVERSION' | 'FEE' | 'REFUND' | 'ADJUSTMENT' | 'INVOICE', required — The transaction type.
    - `currency` string, required — Currency of the transaction. Three-letter ISO 4217 currency code.
    - `amount` string, required — Transaction amount.
    - `credit_debit_type` 'C' | 'D', required — The credit debit type, C for credit and D for debit.
    - `create_time` string, date/time, required — The timestamp when the record was created in the system. Timestamp follows the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard.
    - `complete_time` string, date/time, nullable, required — The timestamp when the request was successfully processed and marked as `COMPLETED`. Returns `null` while the request is still in progress.
    - `reference_id` string, required — The reference ID.
    - `transaction_status` 'FAILED' | 'PENDING' | 'COMPLETED' | 'CANCELLED', required — The transaction status.
    - `transaction_way` string — The transaction way, API for API, empty for other ways.

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)