---
title: "List Balances"
method: GET
path: "/v2/payment/balances"
tags: ["Payment Balances"]
---

# List Balances

`GET /v2/payment/balances`

Retrieve lists of payment currency account balances

## Query parameters

- `page_number` integer, required
- `page_size` integer, required

## Headers

- `x-on-behalf-of` string
- `x-idempotency-key` string, uuid

## Response `200`

List of balances retrieved successfully

- BalanceListResponse
  - `total_pages` integer, required — The total pages of available items.
  - `total_items` integer, required — The total counts of available items.
  - `data` BalanceResponse[], required — List of balance records.
    - `balance_id` string, required — Account balance ID
    - `currency` string, iso-4217, required — Currency of the account balance
    - `available_balance` string, required — Current available balance
    - `payable_balance` string, required — Payable account balance
    - `pending_balance` string, required — Pending balance
    - `reserved_balance` string, required — Reserved balance
    - `margin_balance` string, required — Margin balance
    - `frozen_balance` string, required — Frozen funds

---

[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)