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

# AI usage and credits

> Track monthly AI activity, tokens, credits and wallet charges.

AI usage is metered by default for all organizations. Your plan can include **AI credits** each month, in rupees. If your plan has no included credits, usage is paid from the wallet from the start. Your agents, the assistant, AI replies to leads, suggested replies and business knowledge improvements draw on them as they work. Once the credits for the period are used, AI is paid from your **wallet**, the same one that pays for WhatsApp messages.

## See what you used

Open **Settings → Organization → AI usage**. The current balance is under **Credits now**:

* **Used**: this month's cost and input/output tokens.
* **Credits left**: this month's remaining credits. They renew each month on the day your subscription started. During the free trial you have ₹200 of credits for the whole trial.
* **Paid from the wallet**: usage paid beyond the included credits, and the current wallet balance.

Organization administrators also see **Activity**. Choose the current UTC month or any of the previous eleven months to see:

* Runs and tokens, with a daily activity chart.
* Tokens reused from cache, saved to cache, and used for reasoning, when reported. These are already included in input/output totals. A detail labelled **Not reported** is unknown, rather than zero; older records may have no details.
* Charges covered by credits, paid from the wallet, or left uncovered.
* Usage by feature: agents, AI replies, the assistant (web and WhatsApp), suggested replies, briefings, call reviews and business knowledge.

Selecting an earlier month changes **Activity** only. **Credits now** always shows the current month and current wallet balance. The earlier-month list links directly to each month's activity.

Reports cover recorded text-model activity; AI calling is reported separately. Search embeddings and voice transcription are not included in this report.

The assistant shares the same admin permissions, on the web, mobile and staff WhatsApp. Ask “How much AI have we used this month?” or “Show our AI activity for October 2026.” It can read usage; it does not change prices or your allowance.

## Platform console

Platform administrators with subscription management access can open **Platform → AI usage** for all organizations, then open an organization's **AI** tab for its own report. The console includes breakdowns by feature, model and organization, plus estimated provider costs at the configured rates. Organization settings and assistant answers show only the organization's activity and charges, without models or provider costs.

The private console also records individual AI requests, embedding batches, audio generation, transcription and saved voice-call sessions. It distinguishes successful, failed and unresolved work. Missing measurements or prices are labelled unknown, rather than shown as free use. This operational record does not change customer credits or wallet charges, and is not available through organization settings or the assistant.

Provider costs are estimates, not reconciled invoices or measured cache savings. The organization and model tables show the 100 organizations and 50 models with the most tokens; totals include every recorded run in the selected month.

## When credits run out

When this month's credits are used and the wallet is empty, AI pauses: agents don't start new work, and the assistant asks you to add money. Everything else in the CRM keeps working. Add money to the wallet (Inbox → Settings → Wallet) or wait for the credits to renew on your subscription day, and AI carries on.

## What each AI charge was for

In **Settings → Organization → Wallet → Top-ups and charges**, every AI charge says what it was for instead of just "AI usage":

* **The kind of work**: an assistant reply, an assistant task in the background, a call review, a daily briefing, or an agent working on a lead.
* **Where the assistant was used**: Web, App or WhatsApp. Charges made before this was recorded don't show it.
* **Who or what it was for**: the lead, the person who asked and the name of the assistant chat, when they still exist.
* **How much was read and written**, in tokens. Models and Marro's costs are never shown.

An agent's charge shows that agent's own icon and colour; assistant charges show the assistant's chat icon.

AI calls are paid by the minute from the wallet (see [AI calling](https://docs.marro.si/guides/ai-calling.md)).

## How a price is worked out

Each piece of AI work is priced by how much it read and wrote (tokens), at your plan's AI rate, and rounded up to the paisa. Longer conversations and bigger knowledge lookups cost a little more; short tasks cost very little.

Eligible reused input can use a separate rate. If we cannot verify the rate or usage details needed to price a request, it is recorded without a deduction.

Included credits cover usage first. If a run crosses the credit limit, only the remaining portion is billed at the wallet rate. Wallet payments for AI usage are currently available in INR. If your wallet uses another currency, AI pauses when your included credits run out.


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