List invoices

GEThttps://app.speybooks.com/api/v1/invoices/

Returns a paginated list of invoices for the authenticated organisation, sorted by issue date, most recent first. Filter by type, status, contact, or date range.

The response includes summary statistics: draftCount, sentCount, overdueCount (invoices past their due date that are not paid, cancelled, or written off, whatever their stored status), and outstandingTotal (the unpaid amount across those overdue invoices, in pence).

Query parameters

contactIdstringoptional
fromstringoptional
date
pageintegeroptionalDefault: 1
min: 1
perPageintegeroptionalDefault: 25
min: 1 · max: 100
statusstringoptional
draftsentpartialpaidcancelledwritten_offcreditedvoided
tostringoptional
date
typestringoptionalDefault: sales
salespurchase

Response

200Default Response
Show response fields
invoicesarray<object>
Show child attributes
amountPaidinteger
contactEmailstring
contactIdstring
contactNamestring
createdAtstring
dueDatestring
idstring
invoiceNumberstring
invoiceTypestring
issueDatestring
metadataobject
notesnullstring
statusstring
subtotalinteger
termsnullstring
totalinteger
updatedAtstring
vatAmountinteger
statsobject
Show child attributes
draftCountinteger
outstandingTotalinteger
overdueCountinteger
sentCountinteger