---
title: "List Balances for a Profile"
method: GET
path: "/v4/profiles/{profileId}/balances"
tags: ["balance"]
---

# List Balances for a Profile

`GET /v4/profiles/{profileId}/balances`

Retrieves the user's multi-currency account balance accounts. Returns all balance accounts the profile has in the types specified.

The `types` parameter must include at least one type. To return more than one type, comma-separate the values.

## Path parameters

- `profileId` integer, required

## Query parameters

- `types` string, required

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

OK - Successfully retrieved balances.

- Balance[]
  - `id` integer — Balance ID.
  - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `type` 'STANDARD' | 'SAVINGS' — Type of balance account. - `STANDARD` - Standard balance account. Only one per currency per profile. - `SAVINGS` - Savings balance (Jar). Multiple allowed per currency.
  - `name` string, nullable — Name of the balance. Required for SAVINGS balances.
  - `icon` object, nullable — Icon for the balance.
    - `type` 'EMOJI' — Icon type.
    - `value` string — Icon value (e.g., emoji character).
  - `investmentState` 'NOT_INVESTED' | 'INVESTED' | 'INVESTING' | 'DIVESTING' | 'UNKNOWN' — Investment state of the balance. - `NOT_INVESTED` - Balance is not invested. - `INVESTED` - Balance is invested in assets. - `INVESTING` - Balance is being invested into assets. - `DIVESTING` - Balance is being divested from assets. - `UNKNOWN` - Investment state is unknown.
  - `amount` object — Available balance that can be used to fund transfers.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `reservedAmount` object — Amount reserved for transactions.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `cashAmount` object — Cash amount in the account.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `totalWorth` object — Current total worth.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `creationTime` string, date-time — Date when the balance was created.
  - `modificationTime` string, date-time — Date when the balance was last modified.
  - `visible` boolean — Whether the balance is visible to the user.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)