doctl-balance
retrieve DigitalOcean account billing balance
TLDR
SYNOPSIS
doctl balance command [options]
DESCRIPTION
doctl balance retrieves billing balance information for your DigitalOcean account. It shows the current balance, month-to-date usage, and account balance as of the last invoice.The command provides a quick way to check spending and remaining credits without accessing the web console. This is useful for monitoring costs in automated workflows or scripts.The get subcommand (alias g) is the only available subcommand.
PARAMETERS
get
Retrieve current account balance, month-to-date usage, and balance as of last invoice.--format COLUMNS
Display specific columns (e.g., MonthToDateUsage, AccountBalance, MonthToDateBalance, GeneratedAt).--output FORMAT
Output format: text or json.--help
Display help information.
CAVEATS
Balance updates may have a slight delay from real-time usage. Does not show detailed per-resource cost breakdowns. Requires a valid API token with billing access configured via doctl auth init.
HISTORY
doctl balance is part of the doctl CLI tool, developed and maintained by DigitalOcean for programmatic access to their cloud platform services.
SEE ALSO
doctl(1), doctl-account(1), doctl-auth(1)
