List transactions

GET https://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_1200), 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

accountId string optional
Filter by account ID (e.g. acc_1200). Returns transactions that include this account in any line.
contactId string optional
Filter by contact ID (e.g. cont_3). Returns transactions with this contact on any line.
from string optional
Filter transactions on or after this date (YYYY-MM-DD).
date
page integer optional Default: 1
Page number. Default 1.
min: 1
perPage integer optional Default: 50
Results per page. Default 50, maximum 100.
min: 1 · max: 100
reconciled boolean optional
Filter by reconciliation status. True for reconciled, false for unreconciled.
search string optional
Search by description or reference (case-insensitive partial match).
status string optional
Filter by transaction status.
draftposted
to string optional
Filter transactions on or before this date (YYYY-MM-DD).
date

Response

200 Paginated list of transactions with aggregated debit/credit totals and account labels per transaction.
Show response fields
transactions array<object>
Show child attributes
accountCodes string
date string
description string
id string
status string
totalCredit integer
totalDebit integer

Error codes

400 Invalid account or contact ID format.