# Retrieve a Balance by ID

Returns a balance based on the specified balance ID.

Endpoint: GET /v4/profiles/{profileId}/balances/{balanceId}
Security: UserToken, PersonalToken

## Security:

  - `UserToken` (unknown)
    http bearer JWT

  - `PersonalToken` (unknown)
    http bearer JWT

## Path parameters:

  - `profileId` (integer, required)
    The profile ID.

  - `balanceId` (integer, required)
    The balance ID.

## Header parameters:

  - `X-External-Correlation-Id` (string)
    Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. [Learn more](/guides/developer/headers/correlation-id).

## Response 200:

  - `200` (unknown)
    OK - Successfully retrieved the balance.

## Response 200 fields (application/json):

  - `id` (integer)
    Balance ID.
    Example: 200001

  - `currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: EUR

  - `type` (string)
    Type of balance account.
- `STANDARD` - Standard balance account. Only one per currency per profile.
- `SAVINGS` - Savings balance (Jar). Multiple allowed per currency.
    Enum: "STANDARD", "SAVINGS"

  - `name` (string | null)
    Name of the balance. Required for SAVINGS balances.
    Example: null

  - `icon` (object | null)
    Icon for the balance.
    Example: null

  - `icon.type` (string)
    Icon type.
    Enum: "EMOJI"

  - `icon.value` (string)
    Icon value (e.g., emoji character).

  - `investmentState` (string)
    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.
    Enum: "NOT_INVESTED", "INVESTED", "INVESTING", "DIVESTING", "UNKNOWN"

  - `amount` (object)
    Available balance that can be used to fund transfers.

  - `amount.value` (number)
    Amount value.
    Example: 310.86

  - `amount.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: EUR

  - `reservedAmount` (object)
    Amount reserved for transactions.

  - `reservedAmount.value` (number)
    Amount value.
    Example: 0

  - `reservedAmount.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: EUR

  - `cashAmount` (object)
    Cash amount in the account.

  - `cashAmount.value` (number)
    Amount value.
    Example: 310.86

  - `cashAmount.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: EUR

  - `totalWorth` (object)
    Current total worth.

  - `totalWorth.value` (number)
    Amount value.
    Example: 310.86

  - `totalWorth.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: EUR

  - `creationTime` (string)
    Date when the balance was created.
    Example: 2020-05-20T14:43:16.658Z

  - `modificationTime` (string)
    Date when the balance was last modified.
    Example: 2020-05-20T14:43:16.658Z

  - `visible` (boolean)
    Whether the balance is visible to the user.
    Example: true

## Response 200 headers (application/json):

  - `X-External-Correlation-Id` (string)
    Echoed back when `X-External-Correlation-Id` was included in the request. [Learn more](/guides/developer/headers/correlation-id).
    Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

  - `x-trace-id` (string)
    Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.
    Example: fba501b6d453b96789f52338f019341f

## Response 429:

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

## Response 429 headers (application/json):

  - `Retry-After` (integer)
    Number of seconds to wait before retrying the request.
    Example: 5

  - `X-Rate-Limited-By` (string)
    Identifies the rate limiter that triggered the 429 response.
    Example: wise-public-api

  - `X-External-Correlation-Id` (string)
    Echoed back when `X-External-Correlation-Id` was included in the request. [Learn more](/guides/developer/headers/correlation-id).
    Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

  - `x-trace-id` (string)
    Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.
    Example: fba501b6d453b96789f52338f019341f