Skip to main content
curl -G https://api.chargeapi.co/v1/invoices \
  -H "Authorization: Bearer ch_sk_test_..." \
  -d fleet=flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy \
  -d limit=10
{
    "data": [
        {
            "id": "inv_GVdfAASxxq3iAz32AWC5ZRg0M8gUF8Zk",
            "object": "invoice",
            "amount_due": 2500,
            "amount_paid": null,
            "created": "2026-05-02T00:16:20.899Z",
            "currency": "eur",
            "description": null,
            "due_date": "2026-05-09T00:16:33.313Z",
            "fleet": "flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy",
            "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:16:46.130Z",
            "period_start": "2026-04-01T00:16:18.310Z",
            "status": "draft"
        }
    ],
    "next_page_url": "https://api.chargeapi.co/v1/invoices?page=page_e4VJxs8rZX4qOO9ciSFNA17pmGisk5uD17YbZUiQDj0&fleet=flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy&limit=10",
    "previous_page_url": null
}
Returns a paginated list of invoice objects for the authenticated account, sorted by creation date with the most recent invoices first. Use fleet to scope results to one fleet.
curl -G https://api.chargeapi.co/v1/invoices \
  -H "Authorization: Bearer ch_sk_test_..." \
  -d fleet=flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy \
  -d limit=10
{
    "data": [
        {
            "id": "inv_GVdfAASxxq3iAz32AWC5ZRg0M8gUF8Zk",
            "object": "invoice",
            "amount_due": 2500,
            "amount_paid": null,
            "created": "2026-05-02T00:16:20.899Z",
            "currency": "eur",
            "description": null,
            "due_date": "2026-05-09T00:16:33.313Z",
            "fleet": "flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy",
            "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:16:46.130Z",
            "period_start": "2026-04-01T00:16:18.310Z",
            "status": "draft"
        }
    ],
    "next_page_url": "https://api.chargeapi.co/v1/invoices?page=page_e4VJxs8rZX4qOO9ciSFNA17pmGisk5uD17YbZUiQDj0&fleet=flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy&limit=10",
    "previous_page_url": null
}

Parameters

fleet
string
Limit results to invoices generated for this fleet.
limit
integer
Maximum number of objects to return (default 10).
page
string
Page token from a previous list response.
status
string
Filter invoices by status.Available options: draft, open, paid, void, uncollectible

Returns

Returns a page of invoices.
data
array of object
required
Array of invoice objects.
next_page_url
string | null
required
URL for the next page of results, or null when there is no next page.
previous_page_url
string | null
required
URL for the previous page of results, or null when there is no previous page.