# avr billing Manage billing, invoices, and payment methods. ```sh avr billing [OPTIONS] COMMAND [ARGS]... ``` ## Subcommands ### `avr billing invoices` Manage invoices. ```sh avr billing invoices [OPTIONS] COMMAND [ARGS]... ``` #### `avr billing invoices download` Download an invoice PDF. ```sh 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 .pdf. #### `avr billing invoices list` List invoices. ```sh avr billing invoices list [OPTIONS] ``` ```sh 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. #### `avr billing invoices show` Show details for a single invoice. ```sh avr billing invoices show [OPTIONS] INVOICE_ID ``` ```sh 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. ### `avr billing payment-methods` Manage payment methods. ```sh avr billing payment-methods [OPTIONS] COMMAND [ARGS]... ``` #### `avr billing payment-methods add` Add a credit card as a payment method. ```sh 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)_ #### `avr billing payment-methods list` List payment methods. ```sh avr billing payment-methods list [OPTIONS] ``` ```sh 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. #### `avr billing payment-methods remove` Remove a payment method. ```sh 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. #### `avr billing payment-methods set-default` Set a payment method as the default. ```sh 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). ### `avr billing settings` Show billing settings. ```sh avr billing settings [OPTIONS] ``` ```sh 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. ### `avr billing summary` Show billing summary for the organization. ```sh avr billing summary [OPTIONS] ``` ```sh 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. ### `avr billing update-settings` Update billing settings. ```sh avr billing update-settings [OPTIONS] ``` ```sh 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 ``` ```sh 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.