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

# Account balance — GET /v1/payments/balance

> GET /v1/payments/balance — returns your current account balance. Returns balance_micro_usd, balance_usd, withdrawable_micro_usd, and withdrawable_usd.

The balance endpoint returns your current account balance in both micro-USD (integer) and USD (string). Balances are credited when you deposit via the Darkbloom console and debited after each inference request completes.

`balance_micro_usd` is the canonical value — all internal billing uses micro-USD to avoid floating-point rounding errors. The `balance_usd` string is a human-readable convenience field formatted to six decimal places.

`withdrawable_micro_usd` reflects funds that can be withdrawn (for provider earnings). This will be zero for consumer-only accounts.

## Authentication

This endpoint requires a Bearer token:

```
Authorization: Bearer eigeninference-...
```

## Response

<ResponseField name="balance_micro_usd" type="integer">
  Your current balance in micro-USD (1 USD = 1,000,000 micro-USD). Use this value for precise balance comparisons and cost calculations.
</ResponseField>

<ResponseField name="balance_usd" type="string">
  Your current balance as a USD string formatted to six decimal places, e.g. `"1.250000"`.
</ResponseField>

<ResponseField name="withdrawable_micro_usd" type="integer">
  The portion of your balance available for withdrawal, in micro-USD. For consumer accounts this is typically `0`.
</ResponseField>

<ResponseField name="withdrawable_usd" type="string">
  Withdrawable balance as a USD string formatted to six decimal places.
</ResponseField>

## Example

```bash cURL theme={null}
curl https://api.darkbloom.dev/v1/payments/balance \
  -H "Authorization: Bearer eigeninference-..."
```

### Example response

```json theme={null}
{
  "balance_micro_usd": 4750000,
  "balance_usd": "4.750000",
  "withdrawable_micro_usd": 0,
  "withdrawable_usd": "0.000000"
}
```