StripeKit - List Invoices By Customer

`kit.invoices.listByCustomer()`

Lists a customer's invoices, optionally filtered by status.

Signature

Parameters

Field	Type	Required	Description
`customerId`	`string`	Yes	The customer to list invoices for.
`status`	`string\|null`	No	`'draft'`, `'open'`, `'paid'`, `'uncollectible'`, or `'void'`. Omit for all statuses.
`limit`	`number`	No, defaults to `20`	Maximum number of invoices to return.

Example request

Example response

A plain list, same shape as retrieve() per item.

Errors

Exception	When
`StripeOperationError`	The customer ID does not exist.

Notes

This call does not write to your storage adapter, and does not support cursor pagination beyond limit. For large invoice histories, use the underlying Stripe client directly via kit.raw.

List By Customer

kit.invoices.listByCustomer()#

Signature#

Parameters#

Example request#

Example response#

Errors#