← CLI Reference

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 [--all]

Options:

  • --all: list the plans you can switch to
  • --json: output in JSON format

Examples:

billing plan
billing plan --all   # plans you can switch to

billing usage

Show VM resource usage against your plan quotas

Usage:

billing usage [--range=cycle|24h|7d|30d] [--group=vm]

Options:

  • --group: group usage by: vm
  • --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 payment method

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 [--cpu=N] [--yes]

Options:

  • --cpu: Personal capacity in vCPUs: 2, 4, 8, or 16
  • --json: output in JSON format
  • --yes: skip interactive confirmation (required for non-interactive changes)

Examples:

billing capacity
billing capacity --cpu=4 --yes

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 payment method the default

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 [--email=<email>] [--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
  • --email: billing email 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

Connect a marketplace subscription to your team

Usage:

billing provider link <aws|azure> --token=<link-token> [--size=<team-size>] [--team-name=<name>]

Options:

  • --json: output in JSON format
  • --size: team size: no marketplace team plans are available
  • --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