Skip to main content
curl -X POST https://api.chargeapi.co/v1/invoices \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "period_end": "2026-05-02T00:25:17.494Z",
  "period_start": "2026-04-01T00:25:40.683Z"
}'

{
    "id": "inv_AzC78kBZwIQkgmJeyTANcT9HRINBOfr3",
    "object": "invoice",
    "amount_due": 2500,
    "amount_paid": null,
    "created": "2026-05-02T00:25:46.191Z",
    "currency": "eur",
    "description": null,
    "due_date": "2026-05-09T00:25:36.789Z",
    "fleet": "flt_AAeAlAZzocmSZp6L2mA3rKYNPYyL3GSy",
    "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:25:17.494Z",
    "period_start": "2026-04-01T00:25:40.683Z",
    "status": "draft"
}
Creates a draft invoice for a time window and, optionally, a single fleet. Finalize the invoice when you are ready to lock line items and collect payment. 
curl -X POST https://api.chargeapi.co/v1/invoices \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "period_end": "2026-05-02T00:25:17.494Z",
  "period_start": "2026-04-01T00:25:40.683Z"
}'

{
    "id": "inv_AzC78kBZwIQkgmJeyTANcT9HRINBOfr3",
    "object": "invoice",
    "amount_due": 2500,
    "amount_paid": null,
    "created": "2026-05-02T00:25:46.191Z",
    "currency": "eur",
    "description": null,
    "due_date": "2026-05-09T00:25:36.789Z",
    "fleet": "flt_AAeAlAZzocmSZp6L2mA3rKYNPYyL3GSy",
    "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:25:17.494Z",
    "period_start": "2026-04-01T00:25:40.683Z",
    "status": "draft"
}

​
Parameters

​
fleet
string
Limit the invoice to a single fleet under the account.
​
period_end
string
required
End of the billing window (exclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.
​
period_start
string
required
Start of the billing window (inclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

​
More parameters

​
currency
string
ISO-4217 currency code.
​
description
string
Optional memo that appears on the invoice.
​
metadata
object
Set of key-value pairs that you can attach to an object.

​
Returns

Returns the created invoice.