> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/governance/billing.md).

# Credits & Tokens

Track account credit consumption and control spending from Billing. **Credit Usage** shows consumption and history. **Usage Limits** caps spending and sends threshold alerts.

<figure><img src="/files/OsV8TaLrQH9uB5EhoLz2" alt="The Credit Usage screen, showing available and used credits with a usage trend chart"><figcaption><p>Credit Usage, showing available/used credits and consumption trends.</p></figcaption></figure>

{% columns %}
{% column %}

#### Track spending

Review available and used credits, trends, resource usage, and the full transaction ledger.
{% endcolumn %}

{% column %}

#### Control spending

Create hard limits before requests consume credits. Add alerts for administrators before usage reaches a threshold.
{% endcolumn %}
{% endcolumns %}

#### At a glance

| Area             | Use it to                                           | Start here                    |
| ---------------- | --------------------------------------------------- | ----------------------------- |
| **Credit Usage** | Review consumption, trends, and transaction history | [Credit Usage](#credit-usage) |
| **Usage Limits** | Set hard caps and alert thresholds                  | [Usage Limits](#usage-limits) |

Everything the platform does consumes credits. Usage limits are checked *before* consumption. Requests exceeding a limit are rejected.

### Credit Usage

Credit Usage shows your credit consumption and transaction history. Open **Billing → Credit Usage**.

You can narrow by workspace and date range. The page shows your **Available credits** and **Used credits** for the selected period, with **Usage Trends** plotting consumption over time.

**Resource Usage** breaks spend down by what consumed it, across four tabs — **Apps**, **Agents**, **Models**, and **Features**. Each row lists a resource's **Name**, **Credits Used**, and **Last Used**. Resource usage can lag live activity by up to an hour.

Two shortcuts sit at the top of the page: **Set usage limit** jumps to [Usage Limits](#usage-limits), and **View Ledger** opens your full credit history.

### Credit history

**View Ledger** opens the **Credit History** dialog — every credit and debit transaction on your account:

| Column                 | What it shows                                                                       |
| ---------------------- | ----------------------------------------------------------------------------------- |
| **Operation Type**     | **Debit** (credits spent) or **Credit** (credits added).                            |
| **Additional Details** | What the transaction was for (for example, *Action Deduction*, *Credits Addition*). |
| **Credit Change**      | The amount added or deducted.                                                       |
| **Balance Credit**     | The running balance after the transaction.                                          |
| **Timestamp**          | When it happened.                                                                   |

<figure><img src="/files/Dj6xZs9BSMlgYuBYbIIp" alt="The Credit History dialog, listing debit and credit transactions with running balance"><figcaption><p>The Credit History dialog, opened from View Ledger.</p></figcaption></figure>

### Usage Limits

Usage Limits lets you cap credit consumption and get alerted before you reach a threshold. Open **Billing → Usage Limits**. The page has two sections — limits and alerts — and a **How it works** note.

<figure><img src="/files/XbVP5El9pOKN2GwYOzrJ" alt="The Usage Limits screen, listing configured limits and alerts"><figcaption><p>Usage Limits, with configured limits and alerts.</p></figcaption></figure>

**Usage Limits** are hard caps: requests that would exceed a limit are rejected. Each limit shows its period, its cap, and its type — for example, a **Monthly** limit of `80,000 Credits` as a **Hard Limit** that resets on the 1st of every month. Use **+ Add Limit** to create one, and the per-row menu to edit or remove it.

**Usage Alerts** notify administrators before usage reaches a threshold. Use **+ Add Alerts** to create one.

{% hint style="info" %}
**How it works:** All usage limits are evaluated before credit consumption. If any limit would be exceeded, the request is rejected. Usage alerts send emails once per period when their thresholds are crossed.
{% endhint %}

### Add an alert

**+ Add Alerts** opens the **Add Alert** dialog:

* **Duration** — required. The period the alert evaluates over (for example, **Daily**).
* **Metric Type** — required. **Absolute Credits** alerts on a raw credit count; **Percentage of Limit** alerts on a share of a configured limit.
* **Credit Limit** / threshold — required. The value to alert at. The field matches the metric type — a credit count for **Absolute Credits**, a percentage for **Percentage of Limit**.

<figure><img src="/files/ZEQ6Aa1EvtCgbfptTmyD" alt="The Add Alert dialog, with Duration, Metric Type, and Credit Limit fields"><figcaption><p>The Add Alert dialog.</p></figcaption></figure>

<figure><img src="/files/J3RmsIt8UKk4n0co4Izv" alt="The Metric Type dropdown in the Add Alert dialog, showing Absolute Credits and Percentage of Limit options"><figcaption><p>Choosing between Absolute Credits and Percentage of Limit as the alert metric.</p></figcaption></figure>

### Related

{% content-ref url="/spaces/0qmgQjJ5aArDTj2ACFHG/pages/807cab861e090edd0ce825909db3db1b28f73799" %}
[Control Center](/start-here/control-center.md)
{% endcontent-ref %}

{% content-ref url="/spaces/0qmgQjJ5aArDTj2ACFHG/pages/4d5234c8a07efab44ec5e24cc81c8c08bae3eafc" %}
[Logs & Data](/governance/logs-and-data.md)
{% endcontent-ref %}

{% content-ref url="/spaces/0qmgQjJ5aArDTj2ACFHG/pages/4023fee41d519b1fbe13cbf03c9027c75b45de1a" %}
[Observability](/governance/observability.md)
{% endcontent-ref %}

{% content-ref url="/spaces/0qmgQjJ5aArDTj2ACFHG/pages/84115b130456683eaee9079209f1add7ef90110d" %}
[Account Settings](/governance/account-settings.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.uptiq.ai/governance/billing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.