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

# bead prepaid credit balance

> Check your bead prepaid credit balance and understand reservations, available credit, and funded deadlines.

Your bead prepaid credit balance funds organization machines and retained storage. Check balance before starting work:

```bash theme={null}
bead balance
```

The same read-scoped operation is `GET /billing/credit`.

## Balance, reserved, and available

| Amount | Meaning |
| - | - |
| Balance | Credit remaining after settled grants, usage, and reversals. |
| Reserved | Credit held for authorized work or retained storage that has not fully settled. |
| Available | Credit remaining after reservations. |

A reservation covers worst-case authorized exposure. It is not the final charge. Confirmed usage settles against its reservation. Uncertain authorized usage can remain reserved while reconciliation completes.

Deleting a machine does not turn a missing usage report into zero usage. Check the reconciled balance after cleanup.

## Funded deadlines

Temporary machines have a funded deadline. Adding credit alone does not extend that deadline: extend the machine timeout before it ends if you need more runtime. Temporary machines delete when their lifetime ends.

Persistent machines use rolling funded windows. When another window cannot be funded, the machine pauses. Retained memory and disk enter a configurable credit grace period, which defaults to 14 days. Adding credit can make it resumable again. Read the machine's returned grace deadline.

## Key budgets

A key may also have a lifetime spending ceiling. Both the organization balance and the key budget must cover commitments. Available organization credit does not override an exhausted key budget. See [API key budgets](https://docs.bead.run/platform/key-budgets.md).

## Add funds

[Add credit](https://docs.bead.run/platform/top-up.md) through a persisted purchase, or configure [automatic refill](https://docs.bead.run/platform/auto-refill.md) with admin authority. Trial credit spends before paid deposits because it expires.

Run `bead pricing` or call `GET /v1/pricing` for current rates. See [workload estimates](https://docs.bead.run/platform/estimates.md) before provisioning.


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