Skip to main content

ListInvoices retrieves all invoices for the organization.

GET 
/api/v1/billing/invoices

Returns a paginated list of invoices with optional filtering by status and date range. Invoices are sorted by issue_date descending (newest first).

Authorization​

Requires billing:read permission.

Filtering​

  • status: Filter by invoice status (draft, open, paid, void, uncollectible)
  • start_date/end_date: Filter by issue date range

Response​

Returns paginated list of Invoice objects with line items.

Errors​

  • PERMISSION_DENIED: Caller lacks billing:read permission

Request​

Responses​

A successful response.