Skip to main content
GET
List Invoices

Authorizations

Authorization
string
header
required

Bearer scheme name used by typed customer admin operations.

Query Parameters

status
string

Optional status filter: draft, open, finalized, paid, void, or uncollectible.

period_after
string

Optional inclusive lower bound on period_start (YYYY-MM-DD).

limit
integer<int64>

Page size, clamped to [1, 200]; default 50.

offset
integer<int64>

Result offset for pagination; default 0.

Response

Success

Customer invoice list response.

customer_id
string
required

Stable UUID for the customer account.

invoices
object[]
required

Invoices ordered by period_start descending (nulls last) then by created_at descending so the most recent period is first.

total_count
integer<int64>
required

Total number of invoices matching the filter (independent of limit/offset) so clients can implement pagination indicators.