gpu.aiDocs
CH·02CLI reference

gpu billing invoices

List your invoices (one per payment)

List your invoices (one per payment)

Synopsis

Every payment into your GPU.ai balance gets a numbered invoice: card purchases, auto-pay top ups, and stablecoin deposits. Promotional credit (deposit matches, credit codes, referral bonuses) is not a payment and has no invoice. Invoice numbers are sequential across the platform (GPUAI-000123) and the invoice date is the payment date.

gpu billing invoices download saves one as a PDF. The PDF shows the company name, address and Tax ID set with gpu billing details set, so set those first if your accounting team needs them. Details added after a payment also appear on that payment's invoice.

Invoices are scoped to the org that owns your API key. An invoice id belonging to another organization returns the same "not found" as an id that does not exist.

gpu billing invoices [flags]
gpu billing invoices download <invoice-id> [--out file.pdf]

Examples

# Newest invoices first
gpu billing invoices

# Download one; saved as GPUAI-000123.pdf in the current directory
gpu billing invoices download 6f1c2a9e-4b7d-4e15-9a51-0c3f1d2e8b77

# Download every invoice on the first page
gpu billing invoices --output json | jq -r '.invoices[].id' | \
  xargs -n1 gpu billing invoices download

The PDF is written with owner-only permissions (0600) because it carries your Tax ID.

Options

      --cursor string   Page cursor from a previous listing
  -h, --help            help for invoices
      --limit int       Invoices per page (1-100, default 25)

Options for download

      --out string   Where to write the PDF

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

  • gpu billing - Check your balance, add funds, review deposits, and download invoices
  • gpu billing details - Show the company name, address and Tax ID printed on your invoices

← The gpu CLI