List transactions

GET /v1/transactions

Returns the financial operations of your TransferGo Business Account, newest first.

Pagination

Results are paginated: when more results are available the response carries a nextCursor. Pass it back as the cursor parameter to fetch the next page. A missing nextCursor is the only signal that you've reached the last page.

The filters are bound to the cursor: every request that carries a cursor must repeat the exact same filter parameters as the request that produced it. Changing, adding, or omitting a filter fails with 400 CURSOR_FILTERS_CHANGED. To change the filters, re-issue the request without a cursor to start a new result set. A cursor that has been altered fails with 400 INVALID_CURSOR.

pageSize accepts values between 1 and 100 and defaults to 10 when omitted; anything outside that range fails with 400 INVALID_PAGE_SIZE.

Transaction shape

Every transaction has a type - how it affected your balance - and a subtype, the business reason behind it (a top-up, a currency exchange, a savings movement, and so on). The sender and receiver show where the money came from and where it went.

Transfers and top-ups carry both a sender and a receiver. Every other subtype - currency exchanges, savings deposits and withdrawals, interest, and balance adjustments - only touches one of your balances, so the transaction sets just its sender or just its receiver and leaves the other null.

Your own balances appear as a transferGoAccount or savingsAccount, where only currency is set. An outside party - a bank account, card, payment link, and so on - instead has a name and a display string intended for showing to users (card numbers are masked, e.g. **** 1234).

The table below shows the sender and receiver you can expect for each type and subtype:

`type`	`subtype`	`sender`	`receiver`
`transfer`	`transfer`	External payer	External recipient
`accountOutgoing`	`transfer`	Your TransferGo account	External recipient
`accountIncoming`	`transfer`	External payer	Your TransferGo account
`accountIncoming`	`topup`	External payer	Your TransferGo account
`accountOutgoing`	`exchange`	Your TransferGo account	-
`accountIncoming`	`exchange`	-	Your TransferGo account
`accountOutgoing`	`savingsDeposit`	Your TransferGo account	-
`accountIncoming`	`savingsDeposit`	-	Your savings account
`accountOutgoing`	`savingsWithdrawal`	Your savings account	-
`accountIncoming`	`savingsWithdrawal`	-	Your TransferGo account
`accountIncoming`	`interest`	-	Your savings account
`accountOutgoing`	`balanceAdjustment`	Your savings account	-
`accountIncoming`	`balanceAdjustment`	-	Your savings account

Statuses

statusReason refines the status of some in-flight and failed transactions; for every other transaction it's omitted. Only these combinations occur (new reasons may be added without notice):

`status`	possible `statusReason`
`pending`	`awaitingPayIn`, `awaitingApproval`
`processing`	`payInProcessing` or `null`
`failed`	`payInDeclined` or `null`
all other statuses	always `null`

List transactions

/v1/transactions

Transaction shape

Statuses

Request

Responses

List transactions

/v1/transactions

Pagination​

Transaction shape​

Statuses​

Request​

Responses​

Pagination

Transaction shape

Statuses

Request

Responses