v14

OpenAPI 3.1.02026-08-03122113375.9 KB
user-invoices

List invoices

List Stripe invoices for the authenticated customer.

Use this endpoint for billing history pages and invoice tables.

Pagination:

  • limit controls page size (1-100).
  • startingAfter continues from a previous page token.
  • Response includes hasMore and nextStartingAfter for pagination UX.

Behavior:

  • If the user has no Stripe customer link yet, returns an empty list rather than an error.
get/user/invoices

Query parameters

limitinteger

Maximum number of invoices to return.

Maximum number of invoices to return.

startingAfterstring

Stripe invoice ID to start after. Use the value from nextStartingAfter of the previous response.

Stripe invoice ID to start after. Use the value from nextStartingAfter of the previous response.

Response

Paginated Stripe invoices for the authenticated user.

hasMoreboolean required

Indicates whether more invoices are available beyond the current page.

nextStartingAfterstring nullable required

Identifier to pass as startingAfter in the next request when hasMore is true.