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

# Get Pool Balance

> Returns the current USDC balance breakdown and low-balance alert status for your company, including central pool balance and collated merchant wallet balances.

### Headers

<ParamField header="x-api-key" type="string" required>
  Your test or live SDK API key (`pk_test_...` or `pk_live_...`).
</ParamField>

### Response Fields

<ResponseField name="collated_balance" type="string">
  Total aggregated balance across the central treasury pool and all merchant Privy wallets under the company (in USDC).
</ResponseField>

<ResponseField name="pool_balance" type="string">
  Current balance in the company's central deposit/treasury pool (in USDC).
</ResponseField>

<ResponseField name="merchant_balance" type="string">
  Aggregate balance held across all merchant wallets owned by the company (in USDC).
</ResponseField>

<ResponseField name="balance" type="string">
  Deprecated alias for `pool_balance` maintained for backwards compatibility.
</ResponseField>

<ResponseField name="currency" type="string">
  Settlement currency code (`USDC`).
</ResponseField>

<ResponseField name="low_threshold" type="string">
  Minimum pool balance threshold before low-balance alerts trigger.
</ResponseField>

<ResponseField name="is_low" type="boolean">
  `true` if `pool_balance` is lower than `low_threshold`.
</ResponseField>

<ResponseField name="remaining_before_alert" type="string">
  Difference between `pool_balance` and `low_threshold`.
</ResponseField>

<ResponseField name="auto_top_up_enabled" type="boolean">
  Indicates whether auto-top-up is enabled for the company pool.
</ResponseField>

### Response Example

```json theme={null}
{
  "collated_balance": "6250.750000",
  "pool_balance": "5000.000000",
  "merchant_balance": "1250.750000",
  "balance": "5000.000000",
  "currency": "USDC",
  "low_threshold": "1000.000000",
  "is_low": false,
  "remaining_before_alert": "4000.000000",
  "auto_top_up_enabled": false
}
```
