transactions

List transactions, newest date first (date DESC, id DESC), with cursor pagination and filters

get/households/{householdId}/transactions

Request

  • Base URL: https://api.vokse.ai
  • URL: https://api.vokse.ai/households/{householdId}/transactions
  • Auth: HTTP bearer

Query parameters

limitnumber
Example:50

1..100, default 50

cursorstring

Opaque cursor from the previous page (nextCursor)

maxAmountCentsstring

Cents

minAmountCentsstring

Cents

searchstring
dateTostring

YYYY-MM-DD

dateFromstring

YYYY-MM-DD

source'manual' | 'imported' | 'ai' | 'recurring' | 'split'
statusesstring

Comma-separated statuses (any-of); supersedes status when both are sent

status'pending' | 'cleared' | 'reconciled'
attentionboolean

Rows waiting on the user: needs-review, plus actionable uncategorized outflows that are not reconciled (the account attention count’s predicate)

uncategorizedboolean

Only rows in the budget’s uncategorized bucket: bare outflows on on-budget accounts (cleared or reconciled), never transfer legs or system rows

needsReviewboolean

true = rows awaiting a category decision, false = the rest

hasFlagboolean

Only transactions that carry a flag

flagIdsstring

Comma-separated flag ULIDs (any-of), max 20

hasTagboolean
tagMode'any' | 'all'
tagIdsstring

Comma-separated tag ULIDs, max 20

tagIdstring
payeeIdstring
categoryIdstring
accountIdstring

Changes

No recorded changes to this operation across all 1 revision of this API.