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

# List balances

`GET /balances`

Retrieves a list of balances for the given account

## Query parameters

- `currency` string

## Headers

- `Account` string

## Response `200`

Successfully retrieved the balances for the account

- Balances
  - `items` Balance[]
    - `currency` string — The ISO currency code of the balance
    - `pending` object — The pending amount in the given balance. Pending amounts refer to transactions which have not yet been cleared and made available. At this stage, the total net amount is unknown and you can expect fees to be deducted prior to these amounts becoming available.
      - `amount` integer — The amount in minor units
    - `cleared` object — The cleared amount in the given balance. Cleared amounts refer to transactions which first must go through clearing prior to becoming available. A typical example would be a capture or refund transaction. These are cleared with the card schemes (usually the following day). This value will take into account any deductions during clearing such as fees charged by Ryft or pass through fees such as interchange.
      - `amount` integer — The amount in minor units.
    - `available` object — The available amount in the given balance. Available amounts refer to the funds that can be paid out or transferred. This value will reflect the final net amount and take into account any deduction from fees (such as those charged during processing).
      - `amount` integer — The amount in minor units
    - `lastUpdatedTimestamp` integer, nullable — The epoch timestamp (seconds) when the balance was last updated

## Other responses

- `400` — One or more inputs are invalid
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/a042f64d4305/schema)