---
title: "Invoices"
description: "When invoices are issued and charged, how they are numbered, their statuses, and how to download them."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices

Each organization gets one invoice per billing period (a calendar month in UTC), in US dollars.
You find them in the console under **Billing** > **Invoices**.

## When invoices are issued

An invoice is issued on the first day after its billing period ends, between 06:00 and 24:00
UTC, at a time of day that is the same for your organization every month. A billing period
with no charges has no invoice.

Until then, **View upcoming invoice** shows the current period's invoice as it stands, marked
**Estimate**, with the time it will be issued.

## Invoice contents

- **Line items** are grouped by service, then project, then SKU. Each line is rounded to the cent.
- Lines under half a cent are combined into **Other usage**.
- When an invoice would have more than 250 lines, the smallest project lines of a service are
  combined into **Other projects**.
- A line shows the project's name when the invoice was issued, or "a deleted project".
- The invoice prints the billing contact and address from **Billing details** at the time it was
  issued.

## Numbering

Invoice numbers have the form `EZGH-<year>-<sequence>`, for example `EZGH-2026-000001`. The
sequence has no gaps within a year.

## When you are charged

- **With a default card:** the card is charged when the invoice is issued.
- **Without a default card:** nothing is charged. The invoice is due 14 days after it is issued;
  pay it with **Pay online**.
- **Under $0.50:** the invoice is not charged. It is marked **Carried forward** and its amount is
  added to your next invoice.

If a charge fails, the invoice page shows **The last payment attempt failed** with the reason.
Pay the invoice with **Pay online**, or make a working card the default and the payment is
retried.

## Statuses

| Status | Meaning |
| --- | --- |
| Open | Issued and not yet paid |
| Overdue | Open and past its due date |
| Paid | Paid in full |
| Carried forward | Under $0.50; the amount moved to a later invoice |
| Void | Canceled; nothing is owed |
| Uncollectible | Marked as not collectible |
| Draft | The upcoming invoice, not yet issued |

## Download an invoice

The PDF is the invoice document. Its file name is the invoice number, for example
`EZGH-2026-000001.pdf`. You need the `billing.invoices.get` permission.

### Console

1. Open **Billing** > **Invoices**.
2. Click the invoice number.
3. Click **Download PDF**.

The button is unavailable for a short time after the invoice is issued, while the PDF is
prepared.
### API

List invoices, newest first (`limit` 1 to 100, default 20; pass `nextCursor` as `cursor` for
the next page):

```sh
curl https://billing.ezghcloud.com/v1/organizations/$ORG_ID/invoices \
  -H "Authorization: Bearer $EZGH_API_KEY"
```

Download one invoice's PDF:

```sh
curl -o invoice.pdf \
  https://billing.ezghcloud.com/v1/organizations/$ORG_ID/invoices/$INVOICE_ID/pdf \
  -H "Authorization: Bearer $EZGH_API_KEY"
```

Until the PDF is ready, the request returns `404` with the code `pdf_unavailable`.

Source: https://docs.ezghcloud.com/billing/invoices/index.mdx