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.
- Open Billing > Invoices.
- Click the invoice number.
- Click Download PDF.
The button is unavailable for a short time after the invoice is issued, while the PDF is prepared.
List invoices, newest first (limit 1 to 100, default 20; pass nextCursor as cursor for
the next page):
curl https://billing.ezghcloud.com/v1/organizations/$ORG_ID/invoices \
-H "Authorization: Bearer $EZGH_API_KEY"Download one invoice’s PDF:
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.