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

# Billing and balance

> Add funds, read your balance and reserved funds, set low-balance alerts, and download billing documents.

Athena uses a prepaid balance. Calls draw from it, and each call holds funds while it runs. Open **Billing** from the sidebar to see your balance, add funds, and download documents. The balance also stays visible in the dashboard while you work.

## Read your balance

| Value | Meaning |
| - | - |
| **Balance** | Funds in your account. |
| **Reserved for live calls** | Funds held for calls that are running now. |
| **Available** | What new calls can use. Low-balance alerts compare against this value. |

When a call starts, Athena reserves funds for the call's limit. After the call completes, Athena charges the call and releases the unused part of the hold. Calls are prorated by connected, AI-ready duration and rounded up to the smallest currency unit.

**Billing** shows a phone call rate and a browser call rate. Browser voice calls, such as **Test Audio** in the editor and the website voice widget, use the browser call rate. Your telephony provider bills carrier charges separately.

## Add funds

Choose **Add funds**, enter the amount, choose **Continue to payment**, and pay the invoice that opens. After paying, return to Athena and choose **Check payment** if the balance has not updated yet. A payment that is still awaiting confirmation can be completed from the same invoice later. Purchased credits do not expire.

If **Billing** says online payments are not enabled yet, or that billing is being set up for your organization, contact Athena support to add funds.

## When the balance runs out

A call needs available funds to start. When the balance cannot cover a new call, the call API returns `402` with the reason, and the run is marked as failed without dialing. Add funds before restarting a campaign or retrying calls. See [API quickstart](https://docs.tryopencomputer.com/guides/api.md#read-errors-carefully).

## Set low-balance alerts

**1. Save a billing email**

Under **Billing details**, set **Billing email** and save. Alert emails go to this address.

**2. Choose thresholds**

Under **Low-balance notifications**, enter a warning amount and a critical amount. The critical amount must be lower than the warning amount.

**3. Turn on email alerts**

Enable **Email balance alerts** and save.

Athena sends one warning, one critical, and one exhausted alert per low-balance episode, and resets once available funds recover above the warning threshold. Credit confirmations are sent separately. In-app balance warnings stay active even when email delivery is not configured for your account.

## Download documents and statements

* **Transaction history** lists purchases, charges, and other balance movements. Open a purchase to download its invoice, or a refund to download its confirmation.
* **Documents and statements** downloads a usage statement for a period as CSV or PDF. Statements include posted charges and balance movements in the period; reservations for running calls are temporary holds and are excluded.
* **Billing details** holds the company or customer name and billing address used on documents. Changes apply to future invoices.

## Reconcile a charge

A call charge in **Transaction history** links to its run. Open it to compare the call's duration and outcome with the charge. If **Billing** says some call charges are awaiting usage confirmation, their reserved funds stay held until the charge is confirmed; contact Athena support if the message remains.


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