> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# invoices_list

> List invoices, most recently created first. Filter by customer, subscription, status or collection method.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://api.stripe.com/v1/invoices"}</code></div>

```python stripe_invoices_list.py theme={null}
from charter.packs import stripe

result = await stripe.invoices_list.ainvoke({})
```

<Note>
  Pages by cursor: `data[-1].id` is sent back as `starting_after`.
</Note>

## Query parameters

<div className="reference-table">
  | Field              | Type                                                                             | Description                                                                                                                                                          |
  | ------------------ | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `limit`            | `integer`                                                                        | A limit on the number of objects to be returned, between 1 and 100. Defaults to 10. <span className="field-constraints">≥ 1; ≤ 100; defaults to `10`</span>          |
  | `startingAfter`    | `string`                                                                         | A cursor for use in pagination: an object ID that defines your place in the list. To get the next page, pass the id of the last object in the current page.          |
  | `endingBefore`     | `string`                                                                         | A cursor for use in pagination: an object ID that defines your place in the list. Returns the page before the named object. Mutually exclusive with starting\_after. |
  | `customer`         | `string`                                                                         | Only return invoices for this customer ID.                                                                                                                           |
  | `subscription`     | `string`                                                                         | Only return invoices for this subscription ID.                                                                                                                       |
  | `status`           | [InvoiceStatus](/charter/charter/packs/stripe/invoices/objects#invoicestatus)            | Only return invoices with this status.                                                                                                                               |
  | `collectionMethod` | [CollectionMethod](/charter/charter/packs/stripe/subscriptions/objects#collectionmethod) | Only return invoices collected this way.                                                                                                                             |
  | `created`          | [CreatedFilter](/charter/charter/packs/stripe/payments/objects#createdfilter)            | Only return invoices created in this window.                                                                                                                         |
</div>