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

# Billing

> Manage your Unkey workspace billing, subscription plans, payment methods, and invoices. Track API and Compute usage, set spend budgets, and upgrade or downgrade your plan.

Unkey uses Stripe for all billing. Each workspace has its own subscription, payment method, and invoices. You manage billing from **Settings > Billing** in the dashboard.

## Plans

Unkey offers multiple plan tiers. Every workspace starts on the Free plan. Paid plans unlock higher [limits](/docs/platform/workspaces/quotas), longer data retention, and [team collaboration](/docs/platform/workspaces/team-members).

| Capability             | Free plan     | Paid plans     |
| ---------------------- | ------------- | -------------- |
| API requests per month | 150,000       | Varies by plan |
| Log retention          | 7 days        | Varies by plan |
| Audit log retention    | 30 days       | Varies by plan |
| Team members           | Not available | Included       |

<Tip>
  Visit [unkey.com/pricing](https://unkey.com/pricing) for the latest plan details and pricing.
</Tip>

## Add a payment method

Before upgrading, you must add a payment method.

1. Navigate to **Settings > Billing**.
2. Click **Add payment method**.
3. Complete the Stripe checkout form with your card details and billing address.
4. After saving, you return to the billing page where you can select a plan.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/unkey/x4OlsjqEyio8akfR/platform/workspaces/billing-free-light.png?fit=max&auto=format&n=x4OlsjqEyio8akfR&q=85&s=31b8b23b1a681fa1269cc1c4577d233d" alt="Billing page on Free plan" width="1894" height="814" data-path="platform/workspaces/billing-free-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/unkey/x4OlsjqEyio8akfR/platform/workspaces/billing-free-dark.png?fit=max&auto=format&n=x4OlsjqEyio8akfR&q=85&s=dbe80f4164ded35a6cfcb9e5b56efb22" alt="Billing page on Free plan" width="1894" height="814" data-path="platform/workspaces/billing-free-dark.png" />
</Frame>

## Upgrade your plan

1. Navigate to **Settings > Billing**.
2. Click **Change plan** on the current plan card.
3. Select a plan from the available options. Each plan shows its monthly price and included request quota.
4. Confirm the selection.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/unkey/x4OlsjqEyio8akfR/platform/workspaces/billing-plans-light.png?fit=max&auto=format&n=x4OlsjqEyio8akfR&q=85&s=50126fc0ea31d65ad2fde4ed8e316d98" alt="Plan selection modal" width="1254" height="1400" data-path="platform/workspaces/billing-plans-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/unkey/x4OlsjqEyio8akfR/platform/workspaces/billing-plans-dark.png?fit=max&auto=format&n=x4OlsjqEyio8akfR&q=85&s=5a9d9d933c79bea38a84d55f66425391" alt="Plan selection modal" width="1254" height="1398" data-path="platform/workspaces/billing-plans-dark.png" />
</Frame>

Unkey prorates charges when you upgrade mid-cycle. The difference is applied to your next invoice.

## Downgrade or cancel

1. Navigate to **Settings > Billing**.
2. Click **Cancel plan** at the bottom of the billing page.
3. Confirm the cancellation.

Cancellation takes effect at the end of your current billing period. Your workspace continues to operate with paid plan limits until that date. After the period ends, the workspace reverts to Free plan [defaults](/docs/platform/workspaces/quotas#free-plan-defaults).

If you cancel by mistake, you can resume your subscription from the same billing page before the period ends.

Once subscribed, the billing page shows your current plan, usage, and options to change your plan, open the Stripe billing portal, or cancel.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/unkey/x4OlsjqEyio8akfR/platform/workspaces/billing-paid-light.png?fit=max&auto=format&n=x4OlsjqEyio8akfR&q=85&s=f19626ec6cb4a8046dcae702e3603b07" alt="Billing page on paid plan" width="1874" height="824" data-path="platform/workspaces/billing-paid-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/unkey/x4OlsjqEyio8akfR/platform/workspaces/billing-paid-dark.png?fit=max&auto=format&n=x4OlsjqEyio8akfR&q=85&s=1ad3e47faab69c493e364468756e27a7" alt="Billing page on paid plan" width="1874" height="824" data-path="platform/workspaces/billing-paid-dark.png" />
</Frame>

## Billing portal

The billing portal lets you manage payment methods, view invoices, and update billing details through Stripe.

1. Navigate to **Settings > Billing**.
2. Click **Open Portal**.

The portal opens in a new page hosted by Stripe. From there you can:

* Update or replace your payment method
* Download past invoices
* Update billing contact information

## Usage tracking

The billing page and sidebar display your workspace's usage as a percentage of your monthly request quota. This combines key verifications and rate limit operations for the current billing month.

Unkey sends email notifications when your workspace approaches or exceeds its quota.

## Compute usage

Compute bills for what your workloads actually use: CPU, memory, disk, egress, and the active keys verified through the Compute gateway. Your plan fee comes with usage credits worth the same amount, so the fee already covers your first slice of usage. Anything past those credits is added to your invoice at the end of the month.

The Compute card on the billing page shows:

* **Usage this period**: what you have spent on usage so far this month. This is the number your spend budget is measured against.
* **Per-meter quantities**: CPU hours, memory GiB-hours, egress GiB, disk GiB-hours, and active keys.
* **Spend budget** (optional): your monthly usage-spend cap and its alert thresholds.

Credits refresh at the start of every billing period. If you upgrade partway through a period, you get a prorated top-up to that period's credits.

## Spend budget

Set a monthly spend budget under **Settings > Billing** on the Compute card.

| Setting                          | Behavior                                                                               |
| -------------------------------- | -------------------------------------------------------------------------------------- |
| **Monthly budget**               | Whole dollars. Leave empty for no budget.                                              |
| **Email alerts**                 | Sent at 50%, 75%, and 100% of the budget.                                              |
| **Stop workloads at the budget** | When enabled, your running Compute workloads stop once usage spend reaches the budget. |

The budget caps your total usage spend, credits included. A $100 budget stops you at $100 of usage, not \$100 on top of the credits your plan already includes. The meter on the billing page tracks your spend against the budget so you can see how close you are.

### While Compute is paused

If you turned on **Stop workloads** and hit your budget, Compute pauses and the billing page shows a **Compute paused** banner. It starts back up on its own as soon as you:

* Raise the budget above your current spend,
* Remove the budget,
* Turn off **Stop workloads at the budget**, or
* Reach the next billing period, when usage resets.

Resume is automatic and usually takes about a minute.

## Cancel Compute

Canceling Compute stops your deployments right away and removes the plan. Whatever usage you ran up until then still shows on your final invoice.
