Skip to content

avr billing

Manage billing, invoices, and payment methods.

Terminal window
avr billing [OPTIONS] COMMAND [ARGS]...

Manage invoices.

Terminal window
avr billing invoices [OPTIONS] COMMAND [ARGS]...

Download an invoice PDF.

Terminal window
avr billing invoices download [OPTIONS] INVOICE_ID

Arguments

  • INVOICE_ID

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --out <TEXT> — Output file path. Defaults to <invoice_id>.pdf.

List invoices.

Terminal window
avr billing invoices list [OPTIONS]
Terminal window
JSON FIELDS
created_at, currency, has_pdf, invoice_id, period_end, period_start,
status, subtotal_cents, tax_cents, total_cents

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • -L, --limit <INTEGER RANGE> — Max invoices to return. (default: 50)
  • --offset <INTEGER> — Pagination offset. (default: 0)
  • --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
  • -q, --jq <TEXT> — Filter --json output through a jq expression.

Show details for a single invoice.

Terminal window
avr billing invoices show [OPTIONS] INVOICE_ID
Terminal window
JSON FIELDS
created_at, currency, has_pdf, invoice_id, line_items, period_end,
period_start, status, subtotal_cents, tax_cents, total_cents

Arguments

  • INVOICE_ID

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
  • -q, --jq <TEXT> — Filter --json output through a jq expression.

Manage payment methods.

Terminal window
avr billing payment-methods [OPTIONS] COMMAND [ARGS]...

Add a credit card as a payment method.

Terminal window
avr billing payment-methods add [OPTIONS]

Card details are sent directly to Stripe and never touch Avrea servers.

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --number <TEXT> — Credit card number. Prefer prompting over --number to avoid shell history. (required)
  • --exp-month <INTEGER RANGE> — Card expiration month. (required)
  • --exp-year <INTEGER> — Card expiration year. (required)
  • --cvc <TEXT> — Card CVC/CVV code. Prefer prompting over --cvc to avoid shell history. (required)

List payment methods.

Terminal window
avr billing payment-methods list [OPTIONS]
Terminal window
JSON FIELDS
card_brand, card_exp_month, card_exp_year, card_last4, is_default,
payment_method_id

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
  • -q, --jq <TEXT> — Filter --json output through a jq expression.

Remove a payment method.

Terminal window
avr billing payment-methods remove [OPTIONS] PM_ID

Arguments

  • PM_ID

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --yes — Skip confirmation prompt.

Set a payment method as the default.

Terminal window
avr billing payment-methods set-default [OPTIONS] PM_ID

Arguments

  • PM_ID

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).

Show billing settings.

Terminal window
avr billing settings [OPTIONS]
Terminal window
JSON FIELDS
billing_address, billing_emails, metronome_customer_id,
stripe_customer_id, tax_id

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
  • -q, --jq <TEXT> — Filter --json output through a jq expression.

Show billing summary for the organization.

Terminal window
avr billing summary [OPTIONS]
Terminal window
JSON FIELDS
billing_emails, default_payment_method, has_billing

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
  • -q, --jq <TEXT> — Filter --json output through a jq expression.

Update billing settings.

Terminal window
avr billing update-settings [OPTIONS]
Terminal window
Examples:
avr billing update-settings --email billing@example.com
avr billing update-settings --tax-id EU123456789
avr billing update-settings --email a@example.com,b@example.com --tax-id FI12345678
Terminal window
JSON FIELDS
billing_address, billing_emails, metronome_customer_id,
stripe_customer_id, tax_id

Options

  • --org <TEXT> — Organization ID. Uses default org if not specified (see: avr config set org).
  • --email <TEXT> — Billing email address(es), comma-separated.
  • --tax-id <TEXT> — Tax ID (e.g. VAT number).
  • --json <TEXT> — Output JSON. Pass comma-separated field names, "*" for all fields, or "?" to list available fields.
  • -q, --jq <TEXT> — Filter --json output through a jq expression.