Skip to content

fm billing

Reference for the fm billing command group (auto-generated from fm billing --help).

fm billing

text
Manage billing resources including invoices, payment methods, usage, and credits.

Examples:
  fm billing invoice list
  fm billing usage summary
  fm billing credit balance
  fm billing account

Usage:
  fm billing [command]

Available Commands:
  account        Show billing account details
  credit         Manage credits
  invoice        Manage invoices
  payment-method Manage payment methods
  usage          View usage and costs

Flags:
  -h, --help   help for billing

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm billing [command] --help" for more information about a command.

fm billing account

text
Show the billing account details for the current tenant.

Usage:
  fm billing account [flags]

Flags:
  -h, --help   help for account

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing credit

text
Manage billing credits and promotional codes.

Usage:
  fm billing credit [command]

Aliases:
  credit, credits

Available Commands:
  balance     Show credit balance
  list        List credits
  redeem      Redeem a promotional code

Flags:
  -h, --help   help for credit

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm billing credit [command] --help" for more information about a command.

fm billing credit balance

text
Show the current credit balance.

Usage:
  fm billing credit balance [flags]

Flags:
  -h, --help   help for balance

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing credit list

text
List all credits for the current billing account.

Usage:
  fm billing credit list [flags]

Flags:
  -h, --help          help for list
      --type string   filter by type (promo, refund, adjustment)

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing credit redeem

text
Redeem a promotional code to receive billing credits.

Usage:
  fm billing credit redeem <promo-code> [flags]

Flags:
  -h, --help   help for redeem

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing invoice

text
Manage billing invoices.

Usage:
  fm billing invoice [command]

Aliases:
  invoice, invoices, inv

Available Commands:
  download    Download invoice PDF
  get         Get invoice details
  list        List invoices
  pay         Pay an invoice

Flags:
  -h, --help   help for invoice

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm billing invoice [command] --help" for more information about a command.

fm billing invoice download

text
Download an invoice as a PDF file.

Usage:
  fm billing invoice download <invoice-id> [flags]

Flags:
  -h, --help                 help for download
      --output-file string   output file path (default: invoice-<id>.pdf)

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing invoice get

text
Get detailed information about a specific invoice.

Usage:
  fm billing invoice get <invoice-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing invoice list

text
List all invoices for the current billing account.

Usage:
  fm billing invoice list [flags]

Flags:
      --from string     filter from date (YYYY-MM-DD)
  -h, --help            help for list
      --status string   filter by status (pending, paid, overdue, void)
      --to string       filter to date (YYYY-MM-DD)

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing invoice pay

text
Pay an outstanding invoice using the default or specified payment method.

Usage:
  fm billing invoice pay <invoice-id> [flags]

Flags:
  -h, --help                    help for pay
      --payment-method string   payment method ID to use

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing payment-method

text
Manage payment methods for billing.

Usage:
  fm billing payment-method [command]

Aliases:
  payment-method, payment-methods, pm

Available Commands:
  delete      Delete a payment method
  get         Get payment method details
  list        List payment methods
  set-default Set default payment method

Flags:
  -h, --help   help for payment-method

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm billing payment-method [command] --help" for more information about a command.

fm billing payment-method delete

text
Delete a payment method from the billing account.

Usage:
  fm billing payment-method delete <payment-method-id> [flags]

Flags:
  -h, --help   help for delete

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing payment-method get

text
Get detailed information about a specific payment method.

Usage:
  fm billing payment-method get <payment-method-id> [flags]

Flags:
  -h, --help   help for get

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing payment-method list

text
List all payment methods for the current billing account.

Usage:
  fm billing payment-method list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing payment-method set-default

text
Set a payment method as the default for automatic payments.

Usage:
  fm billing payment-method set-default <payment-method-id> [flags]

Flags:
  -h, --help   help for set-default

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing usage

text
View usage summaries and cost breakdowns.

Usage:
  fm billing usage [command]

Available Commands:
  breakdown   Cost breakdown by resource type
  summary     Current period usage summary

Flags:
  -h, --help   help for usage

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

Use "fm billing usage [command] --help" for more information about a command.

fm billing usage breakdown

text
Show a cost breakdown by resource type for a date range.

Examples:
  fm billing usage breakdown --start 2026-01-01 --end 2026-01-31
  fm billing usage breakdown --start 2026-02-01 --end 2026-02-28

Usage:
  fm billing usage breakdown [flags]

Flags:
      --end string     end date (YYYY-MM-DD, required)
  -h, --help           help for breakdown
      --start string   start date (YYYY-MM-DD, required)

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)

fm billing usage summary

text
Show the usage summary for the current billing period.

Usage:
  fm billing usage summary [flags]

Flags:
  -h, --help   help for summary

Global Flags:
      --config string   config file (default is $HOME/.fm/config.yaml)
  -d, --debug           enable debug/verbose output
      --no-color        disable colored output
  -o, --output string   output format: table, json, yaml, wide (default "table")
  -q, --quiet           suppress non-essential output
      --tenant string   tenant ID to operate on (overrides the active/default tenant; also FM_TENANT)