Summary endpoint for listing invoices
You can list invoices with GET /v1/invoices/summary, a lighter version of the invoices list endpoint that responds faster. Each invoice comes back with its invoice-level fields: customer, status, totals, and dates.
To keep responses fast, the summary leaves out:
- Line items
- Minimums and maximums
- Discounts
It takes the same filters as the full list endpoint, including status, customer, and invoice date, due date, and amount ranges.
Use it when you need to page through invoices quickly, such as a billing history view or a status poll, and fetch an individual invoice when you need its line-item detail. For the current period's accruing charges, use /v1/invoices/upcoming.
This endpoint pairs with GET /v1/subscriptions/summary for subscriptions. Learn more about summary lists in our docs.