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

# The Invoice object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Invoice object theme={null}
    {
        "id": "inv_x1QYytVkSXm5EPAsZCFVnnEW4DSSkY8K",
        "object": "invoice",
        "amount_due": 2500,
        "amount_paid": null,
        "created": "2026-05-02T00:40:50.892Z",
        "currency": "eur",
        "description": null,
        "due_date": "2026-05-09T00:41:23.968Z",
        "fleet": "flt_FCnMkyIiidV4Go6AyA3EkQ8J3to4PYip",
        "line_items": [
            {
                "amount": 1842,
                "description": "Charging sessions for March 2026",
                "quantity": 1,
                "unit_amount": 1842
            },
            {
                "amount": 658,
                "description": "Reservation fees",
                "quantity": 2,
                "unit_amount": 329
            }
        ],
        "metadata": {},
        "paid_at": null,
        "payment_method": null,
        "period_end": "2026-05-02T00:41:19.481Z",
        "period_start": "2026-04-01T00:41:30.118Z",
        "status": "draft"
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Invoice object theme={null}
    {
        "id": "inv_x1QYytVkSXm5EPAsZCFVnnEW4DSSkY8K",
        "object": "invoice",
        "amount_due": 2500,
        "amount_paid": null,
        "created": "2026-05-02T00:40:50.892Z",
        "currency": "eur",
        "description": null,
        "due_date": "2026-05-09T00:41:23.968Z",
        "fleet": "flt_FCnMkyIiidV4Go6AyA3EkQ8J3to4PYip",
        "line_items": [
            {
                "amount": 1842,
                "description": "Charging sessions for March 2026",
                "quantity": 1,
                "unit_amount": 1842
            },
            {
                "amount": 658,
                "description": "Reservation fees",
                "quantity": 2,
                "unit_amount": 329
            }
        ],
        "metadata": {},
        "paid_at": null,
        "payment_method": null,
        "period_end": "2026-05-02T00:41:19.481Z",
        "period_start": "2026-04-01T00:41:30.118Z",
        "status": "draft"
    }
    ```
  </ResponseExample>
</div>

This object represents an invoice in Charge. It records billed items, totals, payment state, and the billing period it covers.

## Attributes

<ResponseField name="id" type="string">
  Unique identifier for the object.
</ResponseField>

<ResponseField name="amount_due" type="integer | null">
  Total amount due on the invoice, in the smallest currency unit.
</ResponseField>

<ResponseField name="currency" type="string">
  ISO 4217 three-letter currency code.
</ResponseField>

<ResponseField name="fleet" type="string | null">
  ID of the fleet billed by this invoice, if the invoice is scoped to a fleet.
</ResponseField>

<ResponseField name="line_items" type="array of object | null">
  Array of individual line items included in the invoice.

  <Expandable title="properties">
    <ResponseField name="amount" type="integer">
      Total amount for this line item in the smallest currency unit.
    </ResponseField>

    <ResponseField name="description" type="string">
      Human-readable description of the billed item.
    </ResponseField>

    <ResponseField name="quantity" type="integer">
      Quantity billed for this line item.
    </ResponseField>

    <ResponseField name="unit_amount" type="integer">
      Unit amount for a single quantity of this line item, in the smallest currency unit.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="payment_method" type="string | null">
  ID of the payment method used to pay the invoice, if applicable.
</ResponseField>

<ResponseField name="status" type="string | null">
  Current status of the invoice.

  Available options: `draft`, `open`, `paid`, `overdue`, `void`
</ResponseField>

## More attributes

<ResponseField name="object" type="string">
  String representing the object's type.
</ResponseField>

<ResponseField name="amount_paid" type="integer | null">
  Total amount paid toward the invoice.
</ResponseField>

<ResponseField name="created" type="string">
  Time at which the invoice was created. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="description" type="string | null">
  Optional memo or description shown on the invoice.
</ResponseField>

<ResponseField name="due_date" type="string | null">
  Time when the invoice is due. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="metadata" type="object">
  Set of key-value pairs that you can attach to an object.
</ResponseField>

<ResponseField name="paid_at" type="string | null">
  Time when the invoice was fully paid, if applicable. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="period_end" type="string | null">
  End of the billing period this invoice covers. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="period_start" type="string | null">
  Start of the billing period this invoice covers. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>