# 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 [--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 ``` **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 ``` **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=] [--name=] [--business-name=] [--phone=] [--address-line1=] [--address-line2=] [--address-city=] [--address-state=] [--address-postal-code=] [--address-country=] [--tax-id-type=] [--tax-id-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=] [--to=] ``` **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=] [--to=] ``` **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 ``` **Options:** - `--json`: output in JSON format ### billing provider link Connect a marketplace subscription to your team **Usage:** ``` billing provider link --token= [--size=small|medium|large|xlarge] [--team-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" ```