---
title: "Get the current balance"
method: GET
path: "/api/balance"
tags: ["Accounts"]
---

# Get the current balance

`GET /api/balance`

Returns the custodial balance. Use `X-On-Behalf-Of` to target a sub-merchant.

## Response `200`

Get the current balance successful

- BalanceDto
  - `currencyName` string, required — Currency name
  - `currencySymbol` string, required — Currency symbol
  - `decimals` number, required — Number of decimals
  - `amountInWei` string, required — Balance expressed in the smallest unit (wei)
  - `readableAmount` string, required — Human-readable balance
  - `custodial` CustodialBalanceDto
    - `address` string, required — Custodial wallet address
    - `amountInWei` string, required — Balance in wei
    - `readableAmount` string, required — Human-readable balance
  - `custodialBalances` CustodialTokenBalanceDto[] — Per-token custodial balances (USDC, EURC, …)
    - `currencyName` string, required
    - `currencySymbol` string, required
    - `decimals` number, required
    - `amountInWei` string, required — Net balance in wei (may be negative when obligations exceed balance)
    - `readableAmount` string, required
    - `pendingObligationsInCents` number — Total pending obligations in cents, present only when obligations exist

## Other responses

- `401` — Unauthorized - Invalid API key

---

[API](https://skmtc.net/inflowpay/apis/inflow-api.md) · [All operations](https://skmtc.net/inflowpay/apis/inflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inflowpay/inflow-api/versions/3012dd3dd14a/schema)