Get the monthly cost report

Choose who receives last month's cost report by e-mail, turn it off, preview a month's report, or send it now.

Last updated 18 November 2026View as Markdown

On the 2nd of each month at 08:00 German time, every organization that had usage in the month before and has not turned the report off is sent that month's report, once: the net total against the month before and why it changed, unusual days, the top movers, what could be saved, the costliest services and resources, and every budget. Attached are cost-lines-YYYY-MM.csv (every resource and usage type of the month) and accounting-YYYY-MM.csv (the DATEV export, see Export costs to DATEV).

Prerequisites

  • Permission for billing:GetCostReportSettings to open Reports & DATEV (without it the page shows an access-denied notice).
  • billing:UpdateCostReportSettings to change the recipients or turn the report off.
  • billing:SendCostReport to send a report now.
  • billing:GetCostAndUsage to preview a month's report.

Choose who gets it

By default the report goes to the organization's owners and the billing account's invoice e-mail. A budget's notification addresses get only that budget's alerts, not the report.

  1. Open Reports & DATEV.
  2. For Recipients, enter the addresses, separated by commas. Leave it empty for the default.
  3. (Optional) Clear Send the monthly cost report to turn it off.
  4. Choose Save.

The page says who it Goes to, and which months were sent.

GET /billing/api/cost-report answers the settings, the effectiveRecipients, and the reports sent: the 24 oldest months sent, oldest first, so once more than 24 months were sent the newest ones are not listed. The console shows the last six of those.

Send a report now

  1. Open Reports & DATEV.
  2. Choose Send last month’s report now, or Send again to send it once more.

The answer's outcome is sent, already_sent (that month went out before; send it with "again": true), disabled (the report is off; with again it is sent anyway), no_recipients (nobody to send it to; the month still counts as sent), or failed. A month is sent once per organization, so a month you send by hand before the 2nd is not sent again on the 2nd. With again, a month goes out once more at most every 10 minutes: sooner is refused with 429 "This month’s report went out less than 10 minutes ago; try again later."

Preview a report

dcloud billing cost-report preview --period 2026-10

The answer is the report as data, without sending it. period defaults to last month.

Did this page help you?