Skip to main content
GET
/
transactions
List transactions
curl --request GET \
  --url https://api.fyatu.com/api/v3.20/transactions \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Transactions retrieved",
  "data": [
    {
      "transactionId": "txn_01HXYZ8888ABCDEF9999",
      "type": "CARD_FUNDING",
      "direction": "DEBIT",
      "status": "SETTLED",
      "amount": 500,
      "currency": "USD",
      "fee": 0,
      "reference": "fund_01HXYZ5555ABCDEF1111",
      "account": "prg_01HXYZ9876ABCDEF0000",
      "memo": "Card funding — crd_01HXYZ5555ABCDEF1111",
      "balanceBefore": 10000,
      "balanceAfter": 9500,
      "relatedTransactionId": null,
      "completedAt": "2026-05-22T14:32:00Z",
      "createdAt": "2026-05-22T14:30:00Z",
      "cardId": "crd_01HXYZ5555ABCDEF1111"
    }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6a7b8c9d0e1f2",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-22T15:00:00Z"
  }
}

​
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

ParameterTypeDefaultDescription
limitinteger20Results per page (max 100)
offsetinteger0Number of records to skip
fromstring30 days agoStart date/time (YYYY-MM-DD or ISO 8601)
tostringnowEnd date/time (YYYY-MM-DD or ISO 8601)
typestring—Filter by type: DEPOSIT, WITHDRAWAL, CARD_FUNDING, CARD_WITHDRAWAL, CARD_ISSUANCE, CARD_TERMINATION_REFUND, INVOICE_PAYMENT, REVERSAL
statusstring—Filter by status: PENDING, SETTLED, FAILED, REVERSED
directionstring—CREDIT or DEBIT
cardIdstring—Filter to movements related to a specific card
searchstring—Search by memo or reference

​
Example

curl -G https://api.fyatu.com/api/v3.20/transactions \
  -H "Authorization: Bearer $FYATU_API_KEY" \
  -d from=2026-05-01 \
  -d to=2026-05-31 \
  -d type=CARD_FUNDING

​
Success Response (200)

{
  "success": true,
  "status":  200,
  "message": "Transactions retrieved",
  "data": [
    {
      "transactionId":        "txn_01HXYZ8888ABCDEF9999",
      "type":                 "CARD_FUNDING",
      "direction":            "DEBIT",
      "status":               "SETTLED",
      "amount":               500.00,
      "currency":             "USD",
      "fee":                  0.00,
      "reference":            "fund_01HXYZ5555ABCDEF1111",
      "account":              "prg_01HXYZ9876ABCDEF0000",
      "memo":                 "Card funding — crd_01HXYZ5555ABCDEF1111",
      "balanceBefore":        10000.00,
      "balanceAfter":         9500.00,
      "relatedTransactionId": null,
      "completedAt":          "2026-05-22T14:32:00Z",
      "createdAt":            "2026-05-22T14:30:00Z",
      "cardId":               "crd_01HXYZ5555ABCDEF1111"
    }
  ],
  "pagination": {
    "total":   47,
    "limit":   20,
    "offset":  0,
    "hasMore": true
  },
  "meta": {
    "requestId":  "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp":  "2026-05-22T15:00:00Z"
  }
}

​
Transaction Types

TypeDirectionDescription
DEPOSITCREDITFunds added to your operational balance
WITHDRAWALDEBITFunds withdrawn from your operational balance
CARD_ISSUANCEDEBITDebit for issuing a new virtual card
CARD_FUNDINGDEBITDebit for loading funds onto a card
CARD_WITHDRAWALCREDITCredit when balance is unloaded from a card
CARD_TERMINATION_REFUNDCREDITRemaining card balance returned when a card is terminated
INVOICE_PAYMENTDEBITMonthly platform fee deducted from your balance
REVERSALVariesCorrection or reversal of a prior transaction

​
Field Reference

FieldDescription
transactionIdUnique transaction identifier
typeMovement type — see table above
directionCREDIT (funds in) or DEBIT (funds out)
statusPENDING, SETTLED, FAILED, or REVERSED
amountTransaction amount in USD
currencyAlways USD
feeFee in USD applied to this transaction (0 when no fee)
referenceInternal reference ID linking to the originating operation
accountProgram ID associated with this movement
memoHuman-readable description of the transaction
balanceBeforeOperational balance in USD before this transaction; null if not recorded
balanceAfterOperational balance in USD after this transaction; null if not recorded
relatedTransactionIdFor reversals, the ID of the original transaction; null otherwise
completedAtISO 8601 timestamp when the transaction settled; empty string if still pending
cardIdCard ID if the movement is card-related; null otherwise

​
Error Codes

CodeHTTPCause
DATE_RANGE_TOO_WIDE422Date range exceeds the 92-day maximum
INSUFFICIENT_SCOPE403Key lacks accounts:read scope

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
string

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