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"
}
Invoices
Create an Invoice
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
string
Limit the invoice to a single fleet under the account.
string
required
End of the billing window (exclusive). RFC 3339 UTC timestamp with millisecond precision, e.g.
2026-03-03T14:05:23.789Z.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
string
ISO-4217 currency code.
string
Optional memo that appears on the invoice.
object
Set of key-value pairs that you can attach to an object.