# List balances

Retrieves a list of balances for the given account

Endpoint: GET /balances
Version: 1.1.0
Security: secretApiKeyAuth

## Header parameters:

  - `Account` (string)
    The linked accountId (use this to list balances for a specific sub account)
    Example: "ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327"

## Query parameters:

  - `currency` (string)
    Filter for one or more currencies. By default all currencies will be returned when this field is omitted.
    Example: "GBP"

## Response 200 fields (application/json):

  - `items` (array)

  - `items.currency` (string)
    The ISO currency code of the balance
    Example: "GBP"

  - `items.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.

  - `items.pending.amount` (integer)
    The amount in minor units
    Example: 500

  - `items.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.

  - `items.cleared.amount` (integer)
    The amount in minor units.
    Example: 500

  - `items.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).

  - `items.lastUpdatedTimestamp` (integer,null)
    The epoch timestamp (seconds) when the balance was last updated
    Example: 1470989538

## Response 400 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"

## Response 500 fields (application/json):

  - `requestId` (string)
    Example: "b83f2653-06d7-44a9-a548-5825e8186004"

  - `code` (string)
    Example: "400"

  - `errors` (array)

  - `errors.message` (string)
    Example: "Required property 'amount' not found in JSON"