Skip to main content
GET
List transactions

Overview

Returns a paginated list of program-balance transactions for the authenticated business, scoped to the API key’s environment. Each record represents a movement of funds in your operational balance — deposits in, card fundings out, invoice payments, and more. By default, results span the last 30 days. The maximum date range is 92 days — use multiple requests for longer histories.

Query Parameters

Example

Success Response (200)

Transaction Types

Field Reference

Error Codes

Authorizations

Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0
from
string

Start date (YYYY-MM-DD or ISO 8601). Defaults to 30 days ago.

to
string

End date (YYYY-MM-DD or ISO 8601). Defaults to now.

type
enum<string>
Available options:
DEPOSIT,
WITHDRAWAL,
CARD_FUNDING,
CARD_WITHDRAWAL,
CARD_ISSUANCE,
CARD_TERMINATION_REFUND,
INVOICE_PAYMENT,
REVERSAL
status
enum<string>
Available options:
PENDING,
SETTLED,
FAILED,
REVERSED
direction
enum<string>
Available options:
CREDIT,
DEBIT
cardId
string

Filter to movements related to a specific card

Search by memo or reference

Response

Transactions retrieved

success
boolean
Example:

true

status
integer
Example:

200

message
string
Example:

"Transactions retrieved"

data
object[]
pagination
object
meta
object