vercel billing

The vercel billing command groups the commands for your team's billing. Use it to check usage and costs, review contract commitments, manage your Spend Management budget, list, inspect, or download invoices, and see an estimate of your next invoice.

Running vercel billing with no subcommand lists these commands.

You can place options before or after subcommands. For example, list budget alerts as JSON:

vercel billing --json budgets alerts list

Use vercel billing invoices to work with your team's invoices from the terminal. vercel billing invoice is an alias. Every subcommand supports --json.

Running vercel billing invoices with no subcommand lists your team's invoices, newest first. list and ls run the same listing.

$ vercel billing invoices list --limit 3
  Team            my-team
 
  Issued       Number          Status   Total    Invoice ID
  2026-10-01   RPKFGFVN-0012   Paid     $10.00   inv_c3RyaXBlOmluXzFVTHFw…
  2026-09-01   RPKFGFVN-0011   Paid     $10.00   inv_c3RyaXBlOmluXzFVQXph…
  2026-08-01   RPKFGFVN-0010   Paid     $10.00   inv_c3RyaXBlOmluXzFUempN…
 
  Next page:
    vercel billing invoices list --limit 3 --next <NEXT_CURSOR>

This example abbreviates invoice IDs and uses <NEXT_CURSOR> for the pagination cursor. Copy the full values from your CLI output.

Use vercel billing invoices inspect <invoice> to show an invoice's status, dates, totals, and line items. Replace <INVOICE_ID> with the full invoice ID from list:

$ vercel billing invoices inspect <INVOICE_ID>
  Invoice         RPKFGFVN-0012
  Status          Paid
  Issued          2026-10-01
  Paid            2026-10-01
  Subtotal        $10.00
  Total           $10.00
  Invoice ID      inv_c3RyaXBlOmluXzFVTHFw…
 
  Item                    Period                     Quantity   Amount
  Fast Data Transfer      2026-09-01 to 2026-10-01   0          $0.00
  Build CPU Minutes       2026-09-01 to 2026-10-01   0          $0.00
  ...

Use vercel billing invoices upcoming to see an estimate of your team's next invoice and its line items. Amounts can change until the end of the billing period. It shows up to five line items. Use --json to read all of them.

This subcommand is available in [email protected] and later.

$ vercel billing invoices upcoming
  Team            my-team
 
  Invoice         Upcoming
  Scheduled       2026-12-01
  Subtotal        $0.00
  Estimated Total $0.00
 
  Item                          Period                     Quantity   Amount
  Blob Storage Size             2026-11-01 to 2026-12-01   0          $0.00
  Private Data Transfer         2026-11-01 to 2026-12-01   0          $0.00
  ...
 
  Amounts are estimates and may change until the end of the billing period.

Upcoming invoices need a team with an active paid subscription and access to its invoices. They have no invoice ID or PDF, so you can't pass them to inspect or download.

Use vercel billing invoices download <invoice> to save an invoice as a PDF. By default, it writes <INVOICE_NUMBER>.pdf to the current directory. It never overwrites an existing file. Replace <INVOICE_ID> with the full invoice ID from list:

vercel billing invoices download <INVOICE_ID> --output invoice.pdf

The following global options can be passed when using the vercel billing command:

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --non-interactive
• --scope
• --team
• --token
• --version

For more information on global options and their usage, refer to the options section.