---
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

---

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