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

# ezforge billing

> Manage your ezForge subscription and view billing status

## Usage

```bash theme={null}
ezforge billing <subcommand> [flags]
```

## Subcommands

| Subcommand | Description                                  |
| ---------- | -------------------------------------------- |
| `upgrade`  | Upgrade to a paid plan via Stripe checkout   |
| `status`   | Show current plan, usage, and billing period |

***

## ezforge billing upgrade

```bash theme={null}
ezforge billing upgrade --plan <plan>
```

Opens a Stripe checkout session in your browser to upgrade your subscription.

### Flags

| Flag            | Description                       |
| --------------- | --------------------------------- |
| `--plan <plan>` | Target plan: `developer` or `pro` |

### Example

```bash theme={null}
# Upgrade to the Developer plan ($29/mo)
ezforge billing upgrade --plan developer

# Upgrade to the Pro plan ($99/mo)
ezforge billing upgrade --plan pro
```

After checkout completes, your new plan takes effect immediately and you are billed a prorated amount for the remainder of the current billing period.

***

## ezforge billing status

```bash theme={null}
ezforge billing status
```

Displays your current subscription plan, usage counters, and the current billing period.

### Example output

```
Plan:         Developer ($29/mo)
Period:       2026-03-01 → 2026-04-01
Requests:     4,312 used  (unlimited)
Servers:      3 of 10

Next renewal: 2026-04-01
```

### JSON output

```bash theme={null}
ezforge billing status --json
```

```json theme={null}
{
  "plan": "developer",
  "periodStart": "2026-03-01T00:00:00Z",
  "periodEnd": "2026-04-01T00:00:00Z",
  "requests": { "used": 4312, "limit": null },
  "servers": { "used": 3, "limit": 10 }
}
```

***

## API equivalent

Both subcommands map to REST endpoints if you prefer the API directly:

| CLI                       | API                          |
| ------------------------- | ---------------------------- |
| `ezforge billing upgrade` | `POST /v1/billing/subscribe` |
| `ezforge billing status`  | `GET /v1/billing`            |

See [Billing API reference](/api-reference/billing) for full request/response schemas.