---
title: "Retrieve Account Balance"
method: POST
path: "/api/service/balance/retrieve"
tags: ["Banking"]
---

# Retrieve Account Balance

`POST /api/service/balance/retrieve`

Retrieve the balance of your Ivy account. The balance is the money currently available on your Ivy account. It is broken down by currency.

## Request body

- RetrieveBalanceDto
  - `currency` 'USD' | 'EUR' | 'GBP' | 'USDC' — The currency to retrieve the balance for. Default account balance for that currency will be retrieved
  - `accountId` string, uuid — The account id to retrieve the balance for. You can find it in the Merchant Dashboard -> Accounts -> Details. If `currency` is provided it will be ignored.

## Response `200`

The account balance

- RetrieveBalanceResponseDto
  - `balances` object[], required — Array of balance information for different currencies
    - `currency` 'USD' | 'EUR' | 'GBP' | 'USDC', required — The currency of the balance
    - `available` number, required — The amount of money available on your Ivy account for this currency

## Changes

- **2026-02-20** `2d2a39758822` — 3 breaking, 3 info
  - removed the enum value `DKK` of the request property `currency`
  - removed the enum value `PLN` of the request property `currency`
  - removed the enum value `SEK` of the request property `currency`
  - removed the `DKK` enum value from the `balances/items/currency` response property for the response status `200`
  - …2 more
- **2026-01-29** `257fc3f4d453` — 1 warning, 3 info
  - added the new `USD` enum value to the `balances/items/currency` response property for the response status `200`
  - added the new optional request property `accountId`
  - the request property `currency` became optional
  - added the new `USD` enum value to the request property `currency`
- **2025-11-13** `8db8d1e5025b` — 1 warning, 1 info
  - added the new `USDC` enum value to the `balances/items/currency` response property for the response status `200`
  - added the new `USDC` enum value to the request property `currency`

[Change history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/balance/retrieve/post.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) · [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)