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.
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:GetCostReportSettingsto open Reports & DATEV (without it the page shows an access-denied notice). billing:UpdateCostReportSettingsto change the recipients or turn the report off.billing:SendCostReportto send a report now.billing:GetCostAndUsageto 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.
- Open Reports & DATEV.
- For Recipients, enter the addresses, separated by commas. Leave it empty for the default.
- (Optional) Clear Send the monthly cost report to turn it off.
- Choose Save.
The page says who it Goes to, and which months were sent.
dcloud billing cost-report update --recipients jane.doe@example.comPUT /billing/api/cost-report
{ "enabled": true, "recipients": ["jane.doe@example.com"] }"recipients": null goes back to the default. Only the fields you send change.
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
- Open Reports & DATEV.
- Choose Send last month’s report now, or Send again to send it once more.
dcloud billing cost-report send --period 2026-10POST /billing/api/cost-report/send
{ "period": "2026-10" }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-10The answer is the report as data, without sending it. period defaults to last month.