---
title: "UpcomingInvoice"
description: "The open period's invoice as it stands: an estimate until the period closes."
---

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

Path: Billing API

The open period's invoice as it stands: an estimate until the period closes.

## Fields

- `UpcomingInvoice.organizationId` (string, required)
- `UpcomingInvoice.periodStart` (string, required)
  - format `date-time`
- `UpcomingInvoice.periodEnd` (string, required)
  - format `date-time`
- `UpcomingInvoice.issuesAt` (string, required)
  - format `date-time`
- `UpcomingInvoice.currency` (string, required)
- `UpcomingInvoice.estimated` (boolean, required)
- `UpcomingInvoice.subtotalMicros` (string, required) — Micros.
  - pattern `^-?[0-9]+(\.[0-9]+)?$`
- `UpcomingInvoice.totalCents` (string, required) — Cents.
  - pattern `^-?[0-9]+(\.[0-9]+)?$`
- `UpcomingInvoice.roundingMicros` (string, required) — Micros.
  - pattern `^-?[0-9]+(\.[0-9]+)?$`
- `UpcomingInvoice.lines` (array<object>, required)
  - `UpcomingInvoice.lines.position` (integer, required)
  - `UpcomingInvoice.lines.kind` (string, required) — usage, other_usage (lines under half a cent) or other_projects (a service's smallest projects, past the line limit).
  - `UpcomingInvoice.lines.service` (string | null, required)
  - `UpcomingInvoice.lines.projectId` (string | null, required)
  - `UpcomingInvoice.lines.projectName` (string | null, required) — The project's name when the invoice was drafted.
  - `UpcomingInvoice.lines.projectSlug` (string | null, required)
  - `UpcomingInvoice.lines.sku` (string | null, required)
  - `UpcomingInvoice.lines.description` (string, required)
  - `UpcomingInvoice.lines.quantity` (string, required) — In the SKU's unit.
    - pattern `^-?[0-9]+(\.[0-9]+)?$`
  - `UpcomingInvoice.lines.unitPrice` (string | null, required) — Dollars per unit; null for folded lines and SKUs whose price changed within the period.
  - `UpcomingInvoice.lines.amount` (string, required) — Exact dollars.
    - pattern `^-?[0-9]+(\.[0-9]+)?$`
  - `UpcomingInvoice.lines.amountMicros` (string, required) — Micros.
    - pattern `^-?[0-9]+(\.[0-9]+)?$`
  - `UpcomingInvoice.lines.amountCents` (string, required) — What's billed, in cents.
    - pattern `^-?[0-9]+(\.[0-9]+)?$`


Source: https://docs.ezghcloud.com/billing-api/schemas/UpcomingInvoice/index.md