# Read and download an invoice

List your organization's invoices, open one with its line items and VAT note, and download it as a PDF.

On the 1st of each month, at 06:00 German time, the usage of the month before becomes one invoice
for every organization that has usage in it. The invoice is numbered when it is issued and is due
14 days later. It records the billing account's name, address and VAT ID, and the VAT treatment, as
they stood at that moment; a later change to the billing account does not change it.

## Prerequisites

- Permission for `billing:GetInvoices`. Without it, **Invoices** shows an access-denied notice, and
  an invoice's own page is not found.

## List and open invoices

**Console**
1. Open **Invoices**.
2. (Optional) Search by number or period, or filter by **Status**.
3. Choose an invoice.

The invoice shows its status, the issue and due dates, **From** and **To**, the **Line items** with
quantity, unit price and amount, the **Total** with VAT, and the VAT note. An invoice that is still
owed shows **How to pay**.

**CLI**
```sh
dcloud billing invoices list --limit 24
```

**API**
```http
GET /billing/api/invoices?limit=24
```

The list is newest first, drafts included, without line items. Over the CLI and the API it holds 12
invoices unless you ask for up to 100 with `limit`; the console's **Invoices** page shows up to
100, the **Billing** page the newest 12.

## Download the PDF

**Console**
1. Open the invoice, then choose **Download PDF**, or choose **PDF** in the list.

**CLI**
```sh
dcloud billing invoices pdf invoice-id > invoice.pdf
```

**API**
```http
GET /billing/api/invoices/invoice-id/pdf
```

The PDF is an A4 document rendered from the invoice as issued. A draft has no number and no PDF:
its PDF answers `404`.

## Invoice statuses

| Status    | Meaning                                           |
| --------- | ------------------------------------------------- |
| `draft`   | Being assembled; no number yet                    |
| `issued`  | Numbered and owed                                 |
| `paid`    | Settled                                           |
| `overdue` | Issued and not paid by its due date               |
| `void`    | Cancelled; it keeps its number and stays readable |

The platform does not change an issued invoice's status by itself: `paid`, `overdue` and `void` are
set by Deutsche Cloud. An invoice whose due date has passed stays `issued` until then.

Invoice numbers are assigned at issue, in one unbroken sequence per year. A line reduced by a
machine's monthly cap says so with the amount it saved, and a line that is metered but not charged
yet is a €0 line saying what it would have cost (see [How you are charged](how-you-are-charged.md)).
Credits and discounts appear as their own lines.

## Related

- [Pay an invoice](pay-an-invoice.md)
- [Set who invoices are made out to](set-billing-details.md)
- `billing.invoices.list` · `dcloud billing invoices list`
