billing
View and manage your billing
View and manage your billing
## Options
- `--json`: output in JSON format
## Subcommands
### billing plan
Show your current plan and resource limits
**Usage:**
```
billing plan
```
**Options:**
- `--json`: output in JSON format
### billing usage
Show VM resource usage against your plan quotas
**Usage:**
```
billing usage [--range=cycle|24h|7d|30d]
```
**Options:**
- `--json`: output in JSON format
- `--range`: time range: cycle (current billing cycle), 24h, 7d, or 30d
**Examples:**
```
billing usage --range=7d
billing credits usage # Shelley/LLM credit spend instead
```
### billing credits
Show Shelley credit balances
**Usage:**
```
billing credits [usage|transactions|buy]
```
**Options:**
- `--json`: output in JSON format
### billing credits usage
Show Shelley (LLM) credit spend by model, day, or VM
**Usage:**
```
billing credits usage [--month=YYYY-MM] [--group=model|day|box] [--detail]
```
**Options:**
- `--detail`: break each group down: models under a day or VM, VMs under a model
- `--group`: group spend by model, day, or box
- `--json`: output in JSON format
- `--month`: calendar month to report, as YYYY-MM (default: this month, UTC)
**Examples:**
```
billing credits usage --group=day
billing credits usage --group=box --detail
billing credits usage --month=2026-05 --group=box
```
### billing credits transactions
Show your credit purchases and gifts
**Usage:**
```
billing credits transactions [--limit=N]
```
**Options:**
- `--json`: output in JSON format
- `--limit`: how many transactions to show, 1-100 (default 20)
### billing credits buy
Buy Shelley credits with your personal card
**Usage:**
```
billing credits buy <dollars> [--yes]
```
**Options:**
- `--idempotency-key`: retry key so a repeated purchase of the same amount charges once
- `--json`: output in JSON format
- `--yes`: skip the confirmation prompt (required when not running interactively)
**Examples:**
```
billing credits buy 25
billing credits buy 100 --yes
```
### billing rewards
Show invite rewards you've earned
**Usage:**
```
billing rewards
```
**Options:**
- `--json`: output in JSON format
### billing capacity
Change your subscription capacity
**Usage:**
```
billing capacity
```
**Options:**
- `--json`: output in JSON format
### billing payment
Show your payment methods
**Usage:**
```
billing payment [list]
```
**Options:**
- `--json`: output in JSON format
### billing payment list
List all payment methods on file
**Usage:**
```
billing payment list
```
**Options:**
- `--json`: output in JSON format
### billing payment remove
Remove a saved payment method
**Usage:**
```
billing payment remove <ref>
```
**Options:**
- `--json`: output in JSON format
**Examples:**
```
billing payment remove 4f1c2a9b8d3e
```
### billing payment default
Make a saved card the default payment method
**Usage:**
```
billing payment default <ref>
```
**Options:**
- `--json`: output in JSON format
**Examples:**
```
billing payment default 4f1c2a9b8d3e
```
### billing manage
Open the billing management page
**Usage:**
```
billing manage
```
**Options:**
- `--json`: output in JSON format
### billing update
Update your billing contact information
**Usage:**
```
billing update [--name=<name>] [--business-name=<name>] [--phone=<phone>] [--address-line1=<line>] [--address-line2=<line>] [--address-city=<city>] [--address-state=<state>] [--address-postal-code=<code>] [--address-country=<country>] [--tax-id-type=<type>] [--tax-id-value=<value>]
```
**Options:**
- `--address-city`: billing address city
- `--address-country`: billing address country code
- `--address-line1`: billing address line 1
- `--address-line2`: billing address line 2
- `--address-postal-code`: billing address postal code
- `--address-state`: billing address state or province
- `--business-name`: business name shown on invoices
- `--json`: output in JSON format
- `--name`: customer name shown on invoices
- `--phone`: phone number shown on invoices
- `--tax-id-type`: tax ID type shown on invoices (e.g. eu_vat, pl_nip, us_ein)
- `--tax-id-value`: tax ID value shown on invoices
### billing invoices
Show recent invoices
**Usage:**
```
billing invoices
```
**Options:**
- `--json`: output in JSON format
### billing receipts
Show credit purchase receipts and purchases (this billing account only)
**Usage:**
```
billing receipts [--from=<YYYY-MM-DD>] [--to=<YYYY-MM-DD>]
```
**Options:**
- `--from`: start of the period, YYYY-MM-DD
- `--json`: output in JSON format
- `--to`: end of the period, YYYY-MM-DD
**Examples:**
```
billing receipts --from=2026-01-01 --to=2026-06-30
```
### billing statement
Open a consolidated credit purchase statement
**Usage:**
```
billing statement [--from=<YYYY-MM-DD>] [--to=<YYYY-MM-DD>]
```
**Options:**
- `--from`: start of the period, YYYY-MM-DD
- `--json`: output in JSON format
- `--to`: end of the period, YYYY-MM-DD
**Examples:**
```
billing statement --from=2026-01-01 --to=2026-06-30
```
### billing provider
Connect a cloud marketplace subscription
**Usage:**
```
billing provider link <aws|azure>
```
**Options:**
- `--json`: output in JSON format
### billing provider link
Connect a marketplace subscription to your team
**Usage:**
```
billing provider link <aws|azure> --token=<link-token> [--size=small|medium|large|xlarge] [--team-name=<name>]
```
**Options:**
- `--json`: output in JSON format
- `--size`: team size: small, medium, large, xlarge
- `--team-name`: name for the team to create (only when you have no team yet)
- `--token`: marketplace link token from the exe.dev link page
**Examples:**
```
billing provider link aws --token=mpl_... --size=medium
billing provider link azure --token=mpl_... --size=large --team-name="Acme Engineering"
```