doctl-billing-history
retrieve DigitalOcean account billing history
TLDR
SYNOPSIS
doctl billing-history command [options]
DESCRIPTION
doctl billing-history (alias bh) retrieves billing events for your DigitalOcean account. Each event includes the date, event type, a description, the amount in USD, and, when applicable, the related invoice ID and UUID.The list subcommand (alias ls) is the only action. Use it to audit charges, credits, and invoice-related events without opening the control panel. Pair InvoiceUUID with doctl invoice get or doctl invoice summary to inspect a specific invoice.
PARAMETERS
list, ls
Retrieve a paginated billing history for the authenticated account.--format COLUMNS
Columns to display. Possible values: `Date`, `Type`, `Description`, `Amount`, `InvoiceID`, `InvoiceUUID`.--no-header
Return raw data with no headers.--output FORMAT
Output format: `text` or `json`.--help, -h
Display help for this command.
CAVEATS
Requires a DigitalOcean API token with billing access. History is paginated through the API; very large accounts may need to page through results. Amounts and dates can lag slightly behind real-time usage. This command does not download invoice PDFs or CSVs; use doctl invoice for that.
SEE ALSO
doctl(1), doctl-balance(1), doctl-invoice(1), doctl-account(1)
