> ## 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.

# List Invoices

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.

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.chargeapi.co/v1/invoices \
    -H "Authorization: Bearer ch_sk_test_..." \
    -d fleet=flt_cb4mG1v23U4O4yo5FmfSdlfYBs4P1Yvy \
    -d limit=10
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "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
  }
  ```
</ResponseExample>

## Parameters

<ParamField query="fleet" type="string">
  Limit results to invoices generated for this fleet.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of objects to return (default 10).
</ParamField>

<ParamField query="page" type="string">
  Page token from a previous list response.
</ParamField>

<ParamField query="status" type="string">
  Filter invoices by status.

  Available options: `draft`, `open`, `paid`, `void`, `uncollectible`
</ParamField>

## Returns

Returns a page of invoices.

<ResponseField name="data" type="array of object" required>
  Array of invoice objects.
</ResponseField>

<ResponseField name="next_page_url" type="string | null" required>
  URL for the next page of results, or `null` when there is no next page.
</ResponseField>

<ResponseField name="previous_page_url" type="string | null" required>
  URL for the previous page of results, or `null` when there is no previous page.
</ResponseField>