The Invoice object

{
    "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"
}

{
    "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"
}

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

Attributes

string

Unique identifier for the object.

integer | null

Total amount due on the invoice, in the smallest currency unit.

string

ISO 4217 three-letter currency code.

string | null

ID of the fleet billed by this invoice, if the invoice is scoped to a fleet.

array of object | null

Array of individual line items included in the invoice.

Show properties

integer

Total amount for this line item in the smallest currency unit.

string

Human-readable description of the billed item.

integer

Quantity billed for this line item.

integer

Unit amount for a single quantity of this line item, in the smallest currency unit.

string | null

ID of the payment method used to pay the invoice, if applicable.

string | null

Current status of the invoice.Available options: draft, open, paid, overdue, void

More attributes

string

String representing the object’s type.

integer | null

Total amount paid toward the invoice.

string

Time at which the invoice was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string | null

Optional memo or description shown on the invoice.

string | null

Time when the invoice is due. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

object

Set of key-value pairs that you can attach to an object.

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.

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.

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.

Getting Started

API Behavior

API Reference

The Invoice object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes