---
title: "Usage and billing"
description: "Plan state, per-Pool budgets, interval usage and cost, alerts and export."
---

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

# Usage and billing

The console answers two separate questions: what am I allowed to do, and what has it cost so far.

## Plan and Agreement

**Billing → Plan** shows the authoritative commercial state for the Organization: channel, Agreement
status, immutable plan revision, funding mode (customer-owned provider credentials, managed credits
or both), Home Cloud, the current period and whether cancellation is pending. Entitlements are read
from that Agreement — the console never invents a capability you were not granted.

## Budgets

Every Pool has a hard monthly budget. A request reserves against it before the upstream is called
and settles the confirmed cost afterwards, so usage is never billed after the fact without a
reservation. When the remaining budget cannot cover a request, the Gateway returns `429`
`quota_hard_budget_exceeded` instead of serving it.

Set a notification threshold per Pool to be warned before the ceiling is reached. The alert records
the exact observed amount, the limit and the period it belongs to.

## Usage and cost by interval

**Billing → Usage** shows the interval view:

- a range selector for the last 24 hours (per UTC hour) and the last 7 or 30 days (per UTC day);
- settled cost and request counts per interval, and a per-Pool breakdown for the same range;
- held reservations and released requests, so an in-flight request is never reported as a charge;
- **Exact interval values**, the table behind the charts, including which intervals the snapshot
  actually covers.

The window always ends at the snapshot's observation time. Intervals before the first recorded
request are shown as **Unavailable**, and a Workspace with no evidence shows an empty state — no
zero is inferred, and no chart is drawn from a single observation.

## Export and deletion

Export returns Workspace configuration and payload-free usage evidence, without secrets or request
content. Deleting a Workspace requires exact Workspace-specific confirmation, revokes and scrubs
mutable customer runtime data, and keeps only the immutable deletion receipt and the evidence
needed to close billing.

## Not yet in the console

Invoices, credit balances and Marketplace self-service purchase are not exposed. Until they are
backed by real projections and actions, the console omits them rather than showing placeholder
records.

Source: https://help.airuntime.dev/accounts/usage-and-billing/index.mdx
