> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ledig.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Balances

> See how much you can spend and how much is held for payments.

Your business has one balance for each currency. Use balances to check your funds before creating a conversion or payment.

## Read your balances

Call `GET /v1/balances` to list your balances. This example uses fictional amounts:

```json theme={null}
{
  "status": "success",
  "data": [
    { "currency": "NGN", "available": "1500000.00", "reserved": "0.00" },
    { "currency": "USDT", "available": "250.00", "reserved": "25.00" }
  ]
}
```

To read one currency, include its code in the path:

```http theme={null}
GET /v1/balances/NGN
```

A currency you have not held before returns a zero balance. You can safely repeat these requests.

## Understand the amounts

| Field | Meaning |
| - | - |
| `currency` | The currency code, such as `NGN` or `USDT`. |
| `available` | Funds available to spend, subject to the payment's fees, limits and requirements. |
| `reserved` | Funds held for a payment that is still being processed. |

In the example above, you have **250 USDT available** and **25 USDT held**. The held amount cannot be spent on another payment.

Amounts are returned as decimal strings. Use a decimal library for calculations so you do not lose precision. Read each currency's decimal precision from `GET /v1/currencies`.

## Read a USD estimate and payout allowance

Call `GET /v1/balances/summary` with `balances:read` to see estimated USD values and `payoutAllowance`. This response must not be cached.

The exact balances remain decimal strings in their original currencies. USD values are indicative estimates, not a quote or a promise that a payment will be accepted.

| Field | Meaning |
| - | - |
| `balanceScope: "profile"` | Estimates cover the selected profile's balances. |
| `valuationStatus: "complete"` | Every returned balance has a USD valuation. |
| `valuationStatus: "partial"` | Some balances could not be valued. Null totals are unavailable, not zero. |
| `valuedSubtotalUsd` | Estimated totals for the balances that could be valued. |
| `payoutAllowance` | The business's per-payment and monthly USD limits, usage, reservations, remaining allowance and reset time. |

Profiles belonging to the same business share its payout allowance. A null limit means unlimited; zero prevents new positive payouts when `enforcementEnabled` is true. Check `enforcementEnabled` before presenting those limits as active. See [Limits](https://docs.ledig.io/guides/limits.md#account-limits) for payment checks and errors.

## Follow balance changes

Use [Transactions](https://docs.ledig.io/guides/transactions.md) to see deposits, conversions and payments. A deposit may need processing before it becomes available. A failed payment may also need time for held funds to be released or deducted funds to be returned.

Read your balance again to confirm the amount available. For a payment's funds status, see [Transfers](https://docs.ledig.io/guides/transfers.md#what-happened-to-the-funds).

Crypto deposit addresses receive funds into your business's currency balance; each address does not have a separate spendable balance.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.