doctl-invoice
retrieve and download DigitalOcean invoices
TLDR
SYNOPSIS
doctl invoice command [arguments] [options]
DESCRIPTION
doctl invoice retrieves invoices for the authenticated DigitalOcean account. Use list to find invoice UUIDs, then get for line items or summary for period totals, company/email, usage, overages, taxes, and credits.pdf and csv write a file to the path you pass as the second argument. The UUID comes from doctl invoice list. For a running tally of charges rather than closed invoices, use doctl billing-history and doctl balance.
PARAMETERS
list, ls
List invoices on the account (UUID, amount in USD, billing period).get, g invoice-uuid
Retrieve an itemized list of resources and charges on an invoice.summary, s invoice-uuid
Retrieve invoice totals: product usage, overages, taxes, credits, and billing contact.pdf, p invoice-uuid output-file.pdf
Download a PDF of the invoice to output-file.pdf.csv, c invoice-uuid output-file.csv
Download a CSV of the invoice to output-file.csv.--format COLUMNS
Columns for list/get/summary. Possible values include `Product`, `Amount`, `Description`, `StartTime`, `EndTime`, `ProjectName`, `Category`.--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. pdf and csv need a destination filename; they do not print the file to stdout. Invoice data is historical; in-progress usage appears on the next invoice and in doctl balance.
SEE ALSO
doctl(1), doctl-billing-history(1), doctl-balance(1), doctl-account(1)
