# 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](export-to-datev.md)).

## 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.

**Console**
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.

**CLI**
```sh
dcloud billing cost-report update --recipients jane.doe@example.com
```

**API**
```http
PUT /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

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

**CLI**
```sh
dcloud billing cost-report send --period 2026-10
```

**API**
```http
POST /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

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

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

## Related

- [Save and mail a cost view](save-a-cost-view.md)
- [Export costs to DATEV](export-to-datev.md)
- `billing.cost-report.send` · `dcloud billing cost-report send`
