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

# Billing overview

> Plan, usage, and how you're charged.

Billing is workspace-scoped. Each workspace has its own plan, its own usage meters, and its own invoices.

## Plans

| Plan           | Included                                                                           | Best for                           |
| -------------- | ---------------------------------------------------------------------------------- | ---------------------------------- |
| **Free**       | Small quotas, 30-day audit retention, community support                            | Trying it out, small side projects |
| **Team**       | Bigger quotas, 1-year audit, priority support, workspace tokens with custom scopes | Working teams                      |
| **Enterprise** | Custom quotas, unlimited audit, SSO, BYOK, BAA, region pinning, dedicated support  | Regulated / large orgs             |

Full plan comparison: [nora.my/pricing](https://nora.my/pricing).

## What's metered

* **Model calls** — per provider tier (managed models only; BYO-key models are billed by the provider).
* **Storage** — documents, chunks, memory items.
* **Trace retention** — active traces + retained payloads.
* **Foundry runs** — pipeline executions.
* **Improvements** — improvement flow computations.

Meters are visible under **Settings → Billing → Usage** and via `nora billing usage`.

## Current usage

**Settings → Billing → Usage**:

* Per-meter numbers for the current period.
* Included quota per meter.
* Overage (usage above quota) with cost.

CLI:

```bash theme={null}
nora billing usage
```

## Historical usage

**Settings → Billing → History**. Monthly rollup, last 12 months:

* Per-meter usage.
* Total cost per month.
* Overage cost per month.

Useful for cost forecasting and detecting month-over-month spikes.

```bash theme={null}
nora billing history --from 2026-01-01 --to 2026-06-30
```

## Overage

When usage exceeds included quota, overage kicks in — additional per-unit charges. Overage cap (see [Overage](/settings/billing/overage)) is your safety net against runaway costs.

## Customer portal

Payment method, billing email, invoice PDFs — managed via our payment provider's hosted portal:

**Settings → Billing → Manage payment method** → opens the portal in a new tab.

Or:

```bash theme={null}
nora billing portal --launch
```

Portal login uses the same email as your Nora Owner account.

## Plan changes

Upgrading (Free → Team, Team → Enterprise) is instant. Downgrading:

* **Immediately** — takes effect at the end of the current billing period.
* **At renewal only** — the default. Prevents mid-period data loss when quotas shrink.

Downgrade may reveal that current usage exceeds the smaller plan's quotas — Nora warns and suggests cleanup (retention shortening, pipeline pruning) before the transition.

## Free-tier limits

Free workspaces have:

* Runtime rate limits (max runs per minute).
* No workspace tokens (personal tokens only).
* No custom retention (defaults only).
* No SSO.
* Public status page for outages only (no dedicated support).

Fine for evaluation and small projects. Upgrade for any production use.

## Payment methods

* **Credit card** — via the payment provider portal. Any major card.
* **Bank transfer / invoicing** — Team plan and above, on request.
* **ACH / SEPA** — Enterprise.

Contact support if your finance team requires a specific arrangement.

## Multiple workspaces on one account

Each workspace is billed independently — separate plan, separate invoices, separate payment method (or shared, if you configure the portal that way).

Common structure:

* **Prod workspace** — Team or Enterprise, actively billed.
* **Staging / dev workspaces** — Team, lighter usage.
* **Personal sandbox** — Free.

## Tax

For Korean and other regimes with tax invoice requirements, add business tax info:

**Settings → Billing → Tax**:

```bash theme={null}
nora billing set-tax \
  --business-number "123-45-67890" \
  --tax-email billing@yourcompany.com
```

See [Tax](/settings/billing/tax).

## Invoices

Every billing period generates an invoice. **Settings → Billing → Invoices** shows them all:

* Invoice number.
* Period.
* Amount.
* Status (paid / open / uncollectible).
* PDF download.

See [Invoices](/settings/billing/invoices).

## Cost attribution

For per-tenant / per-user cost attribution within a workspace:

* Traces carry scope keys.
* **Insights → Cost by scope** aggregates.
* Export via API for internal chargeback.

Combines with per-workspace provider keys to give clean per-team cost views on the provider dashboard as well.

## Related

* [Invoices](/settings/billing/invoices)
* [Tax](/settings/billing/tax)
* [Overage cap](/settings/billing/overage)
* [`nora billing`](/cli/billing) — CLI reference.
* [Providers](/settings/models/providers) — separate from Nora billing; billed by the provider directly.