List invoices

GET https://app.speybooks.com/api/v1/invoices/

Returns a paginated list of invoices for the authenticated organisation. Invoices are sorted by issue date, most recent first.

Use query parameters to filter by type, status, contact, or date range. The response includes summary statistics for the filtered result set.

Query parameters

contactId string optional
from string optional
date
page integer optional Default: 1
min: 1
perPage integer optional Default: 25
min: 1 · max: 100
status string optional
draftsentpaidpartialoverduecancelledwritten_off
to string optional
date
type string optional Default: sales
salespurchase

Response

200 Default Response
Show response fields
invoices array<object>
Show child attributes
amountPaid integer
contactEmail string
contactId string
contactName string
createdAt string
dueDate string
id string
invoiceNumber string
invoiceType string
issueDate string
metadata object
notes string
status string
subtotal integer
terms string
total integer
updatedAt string
vatAmount integer
stats object
Show child attributes
draftCount integer
outstandingTotal integer
overdueCount integer
sentCount integer