---
title: "list invoices · RUAL Documentation"
description: "The billing history for a customer or a subscription, newest first. Set at least one of the two filters : unfiltered this would walk the whole account.…"
canonical: https://docs.rual.nl/block-types/stripe/stripeconnection_invoices_list
language: en
---

# list invoices

This block is part of the [`stripe`](https://docs.rual.nl/block-types/stripe) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

The billing history for a customer or a subscription, newest first. Set at least one of the two filters : unfiltered this would walk the whole account. The `latest invoice` pins are the shortcut for "credit their last month".

- flow `flow`

- connection required `stripeconnection`

- customer id `value`

- subscription id `value`

- status `value` `draft`, `open`, `paid`, `uncollectible` or `void`. A credit note needs an open or paid one. • Suggestions: `draft` `open` `paid` `uncollectible` `void`

- limit `number` Default 10, maximum 100.

- flow `flow`

- connection `stripeconnection`

- invoices `array ` Newest first.

- count `number`

- has more `condition` True when the account has more invoices past the limit.

- latest invoice id `value`

- latest invoice `object`

- success `condition`

- error `value` Stripe's own message, or a sentinel like MISSING_SESSION_ID for a problem in the wiring.

- error code `value` Stripe's machine-readable code, e.g. `card_declined`, `resource_missing`.

- decline code `value` Why the bank refused, e.g. `insufficient_funds`. Only set on a declined card.

| `invoices` |
| --- |
| `billing history` |
| `find invoice` |

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

### Service documentation