List transactions

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

Returns a paginated list of transactions for the authenticated organisation, sorted by date descending (most recent first). Default pagination: page 1, 50 per page (max 100).

Filters

  • from / to: date range (YYYY-MM-DD)
  • status: draft or posted
  • reconciled: boolean
  • accountId: prefixed account ID (e.g. acc_1100), returns transactions with at least one line on that account
  • contactId: prefixed contact ID, returns transactions with at least one line referencing that contact
  • search: free-text ILIKE search across description and reference fields

Each transaction in the list includes aggregated totals (debit, credit) and the account codes involved, without the full line detail. Use the get endpoint for complete line-level data.

Query parameters

accountIdstringoptional
Filter by account ID (e.g. acc_1200). Returns transactions that include this account in any line.
contactIdstringoptional
Filter by contact ID (e.g. cont_3). Returns transactions with this contact on any line.
fromstringoptional
Filter transactions on or after this date (YYYY-MM-DD).
date
pageintegeroptionalDefault: 1
Page number. Default 1.
min: 1
perPageintegeroptionalDefault: 50
Results per page. Default 50, maximum 100.
min: 1 · max: 100
reconciledbooleanoptional
Filter by reconciliation status. True for reconciled, false for unreconciled.
searchstringoptional
Search by description or reference (case-insensitive partial match).
statusstringoptional
Filter by transaction status.
draftposted
tostringoptional
Filter transactions on or before this date (YYYY-MM-DD).
date

Response

200Paginated list of transactions with aggregated debit/credit totals and account labels per transaction.
Show response fields
transactionsarray<object>
Show child attributes
accountCodesstring
accountLabelsstring
createdAtstringdate-time
createdBystring
createdByNamestring
datestring
descriptionstring
idstring
isReconciledboolean
metadataobject
reconciledAtstringnullable
referencestring
sourceIdstring
sourceTypestring
statusstring
totalCreditinteger
totalDebitinteger
updatedAtstringdate-time

Error codes

400Invalid account or contact ID format.