Transactions

​

What a transaction carries

• Direction and amount: credit or debit relative to your account, the absolute amount, and the account’s currency.
• The account it was booked on.
• The cause: the deposit, payout, or return that moved the money, so you can open it on its own endpoint.
• The other party: the bank account or wallet on the far side, and the saved counterparty it resolved to where there is one.
• References: the remittance text that travelled with the transfer and the network reference where the rail has one (for example the UETR on SWIFT).
• Booking time: when the movement was recorded on the Augustus ledger. A credit books when the funds settled on your account. A debit books when the payout or return was initiated, which is when the amount leaves your available balance.

​

List transactions

import Augustus from '@augustusbank/typescript-sdk'

const client = new Augustus()
for await (const transaction of client.transactions.list({
  account_id: 'your-account-id',
  booked_at: { gte: '2026-09-01T00:00:00Z', lte: '2026-09-02T00:00:00Z' },
})) {
  // process transaction
}

import Ivy from '@getivy/node-sdk'

const client = new Ivy()
let afterCursor: string | undefined
do {
  const page = await client.transactions.list({
    accountId: 'your-account-id',
    from: 1756684800,
    to: 1756771200,
    afterCursor,
  })
  for (const transaction of page.data) {
    // process transaction
  }
  afterCursor = page.paging.nextCursor
} while (afterCursor)

​

Retrieve a transaction

const transaction = await client.transactions.retrieve('your-transaction-id')

​

Reconcile against your records

• Find the cause. Open the deposit, payout, or return the transaction points to and match it to your own record by its ID or by the remittance text you set.
• Match returns by reference, not by amount. A return that references the original payment moves the payout to returned; one that does not arrives as a new deposit. International returns can come back net of correspondent fees, so correlate on the payment reference, never on the amount. See Returned payouts.
• Point-in-time balance.

​

In the Dashboard