Skip to main content

List Invoices (V2)

GET 
/api/xero/v2/invoices

Paginated list of Xero invoices (ACCREC type) with advanced filtering via Spatie QueryBuilder + GroupedFilterSupport.

Authentication: Requires Bearer token.

Sort options: id, xero_uuid, InvoiceNumber, Status, Date, DueDate, Total, AmountDue, AmountPaid, ContactName, CurrencyCode, updated_at, created_at. Default: -updated_at

Filterable columns:

  • Text: xero_uuid, InvoiceNumber, Reference, Status, sync_status, CurrencyCode, ContactID, ContactName, last_error, has_error (boolean-like), has_sku_link (boolean-like), sku_reference
  • Numeric: id, Total, SubTotal, TotalTax, AmountDue, AmountPaid, AmountCredited
  • Date (millis): Date, DueDate, FullyPaidOnDate, UpdatedDateUTC

Each row includes: at_id, at_reference, at_type, sku_link_type, sku_link_id (flattened from accountingTransaction relation)

Request​

Responses​

Successful response