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
  override       Manage a tenant's billing override (reference, extra recipient)
  payment-method Manage payment methods
  profile        Manage your organization's billing profile
  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. With --organization, list every invoice of the selected tenant's organization instead (--tenant or 'fm tenant use' picks the tenant).

Usage:
  fm billing invoice list [flags]

Flags:
      --for-tenant string   with --organization: only invoices with a section for this tenant ID
      --from string         filter from date (YYYY-MM-DD)
  -h, --help                help for list
      --organization        list every invoice of the selected tenant's organization (owner and billing role only)
      --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 override ​

text
Manage the selected tenant's billing override: the reference printed on its
invoices ("Er referens" / cost centre) and one extra address its invoices are
mailed to. Acts on the tenant selected with --tenant or 'fm tenant use'.
Needs the organization owner or billing role and a signed-in user.

Usage:
  fm billing override [command]

Available Commands:
  clear       Remove the tenant's billing override
  get         Show the tenant's billing override
  set         Create or update the tenant's billing override

Flags:
  -h, --help   help for override

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 override [command] --help" for more information about a command.

fm billing override clear ​

text
Remove the tenant's billing override

Usage:
  fm billing override clear [flags]

Flags:
  -h, --help   help for clear

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 override get ​

text
Show the tenant's billing override

Usage:
  fm billing override get [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 override set ​

text
Create or update the selected tenant's billing override. Only the fields you
pass change; pass an empty value ('') to clear one.

Changing the extra recipient notifies the previous address, the organization
owner and every billing member.

Usage:
  fm billing override set [flags]

Flags:
      --extra-recipient-email string   one extra address the tenant's invoices are mailed to
  -h, --help                           help for set
      --reference string               reference / cost centre printed on the tenant's invoices

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 profile ​

text
Manage the organization billing profile: one legal name, address and billing
email for every tenant of the organization.

These commands act on the organization that owns the selected tenant: pass
--tenant <tenant-id> or run 'fm tenant use <tenant-id>' to pick a tenant of
another organization. Without either, your default tenant is used.
They need a signed-in user ('fm auth login'); API keys are refused.

Usage:
  fm billing profile [command]

Available Commands:
  get         Show the organization billing profile
  set         Create or update the organization billing profile

Flags:
  -h, --help   help for profile

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 profile [command] --help" for more information about a command.

fm billing profile get ​

text
Show the organization billing profile

Usage:
  fm billing profile get [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 profile set ​

text
Create or update the organization billing profile. Only the fields you pass
change; everything else is kept as it is.

Changing the billing email notifies the previous address, the organization
owner and every billing member.

Examples:
  fm billing profile set --email invoices@example.com
  fm billing profile set --mode per-tenant
  fm billing profile set --legal-name "Example AB" --org-number 5560000000 \
    --address-line1 "Storgatan 1" --address-city Stockholm \
    --address-postal-code "111 22" --address-country SE

Usage:
  fm billing profile set [flags]

Flags:
      --address-city string          address: city
      --address-country string       address: country code (e.g. SE)
      --address-line1 string         address: street
      --address-line2 string         address: second line
      --address-name string          address: recipient name
      --address-postal-code string   address: postal code
      --customer-type string         business or individual
      --email string                 billing email invoices are sent to
  -h, --help                         help for set
      --legal-name string            legal name of the buyer
      --mode string                  invoicing mode: consolidated or per-tenant
      --org-number string            organization number (businesses only)
      --vat-number string            VAT number

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)