Skip to main content
GET
/
account
/
transactions
Get Transactions
curl --request GET \
  --url https://api.fyatu.com/api/v3/account/transactions \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Transactions retrieved successfully",
  "data": {
    "pagination": {
      "page": 1,
      "perPage": 50,
      "totalItems": 7,
      "totalPages": 1
    },
    "transactions": [
      {
        "transactionId": "DEP69FE561280613",
        "reference": "CQDX4LIBSORF",
        "type": "CREDIT",
        "category": "DEPOSIT",
        "amount": 100,
        "fee": 0,
        "currency": "USD",
        "status": "COMPLETED",
        "description": "Deposit of 100 USD",
        "createdAt": "2026-05-08T21:30:58Z",
        "updatedAt": "2026-05-08T21:30:58Z"
      },
      {
        "transactionId": "FYB69F984AA38EFB",
        "reference": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1",
        "type": "DEBIT",
        "category": "ISSUANCE",
        "amount": 30,
        "fee": 5,
        "currency": "USD",
        "status": "COMPLETED",
        "description": "Card Issuance - 515253******1234 (Alice Example)",
        "createdAt": "2026-05-05T08:00:00Z",
        "updatedAt": "2026-05-05T08:00:15Z"
      },
      {
        "transactionId": "FYB69E12BC34DE56",
        "reference": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1",
        "type": "DEBIT",
        "category": "FUNDING",
        "amount": 50,
        "fee": 0.5,
        "currency": "USD",
        "status": "COMPLETED",
        "description": "Card Funding - 515253******1234 (Alice Example)",
        "createdAt": "2026-05-05T09:00:00Z",
        "updatedAt": "2026-05-05T09:00:00Z"
      },
      {
        "transactionId": "FYB69A78CD90EF12",
        "reference": "b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
        "type": "CREDIT",
        "category": "UNLOADING",
        "amount": 20,
        "fee": 0,
        "currency": "USD",
        "status": "COMPLETED",
        "description": "Card Unload - 515253******5678 (Bob Example)",
        "createdAt": "2026-05-06T10:00:00Z",
        "updatedAt": "2026-05-06T10:00:00Z"
      },
      {
        "transactionId": "FYB69B11CC22DD33",
        "reference": "b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
        "type": "CREDIT",
        "category": "TERMINATION",
        "amount": 15,
        "fee": 0,
        "currency": "USD",
        "status": "COMPLETED",
        "description": "Card Termination - 515253******5678 (Bob Example)",
        "createdAt": "2026-05-07T11:00:00Z",
        "updatedAt": "2026-05-07T11:00:00Z"
      },
      {
        "transactionId": "FYB69EE099B77FBB",
        "reference": "P2P69EE099B741DB",
        "type": "CREDIT",
        "category": "TRANSFER",
        "amount": 25,
        "fee": 0,
        "currency": "USD",
        "status": "COMPLETED",
        "description": "Bob Example",
        "createdAt": "2026-05-07T14:00:00Z",
        "updatedAt": "2026-05-07T14:00:00Z"
      },
      {
        "transactionId": "DEP67EA9E8789B79",
        "reference": "c802f8a9db4c15878ea43bdff610261ff1df7726dccfc4b6365e4e44d62dac88",
        "type": "CREDIT",
        "category": "DEPOSIT",
        "amount": 43.65,
        "fee": 1.35,
        "currency": "USDT",
        "status": "COMPLETED",
        "description": "USDT",
        "createdAt": "2026-05-08T09:00:00Z",
        "updatedAt": "2026-05-08T09:00:00Z"
      }
    ]
  },
  "meta": {
    "requestId": "req_7af4d2b8e91c35fa4b21890e",
    "timestamp": "2026-05-08T21:42:53Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Retrieve a paginated list of all transactions on your business account. This includes card issuance, funding, unloading, termination, transfers, collections, payouts, and deposits.

​
Filtering

ParameterDescription
typeFilter by transaction direction: CREDIT or DEBIT
statusFilter by status: PENDING, COMPLETED, FAILED, PROCESSING

​
Pagination

ParameterDefaultMax
page1-
perPage50100

​
Response Fields

FieldTypeDescription
transactionIdstringUnique transaction batch ID
referencestringCard ID, payment reference, or on-chain hash depending on category
typestringCREDIT or DEBIT
categorystringDEPOSIT, WITHDRAW, ISSUANCE, FUNDING, UNLOADING, TERMINATION, TRANSFER, COLLECTION, PAYOUT, AIRTIME
amountnumberTransaction amount
feenumberFee charged for this transaction
currencystringUSD or USDT for crypto deposits
statusstringPENDING, COMPLETED, FAILED, or PROCESSING
descriptionstringCardholder name, counterparty, or asset name
createdAtstringISO 8601 timestamp
updatedAtstringISO 8601 timestamp of last status change

​
Example Usage

const response = await fetch('https://api.fyatu.com/api/v3/account/transactions?page=1&perPage=50', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const { data } = await response.json();

console.log(`Total transactions: ${data.pagination.totalItems}`);
data.transactions.forEach(tx => {
  console.log(`${tx.type} (${tx.category}): $${tx.amount} — ${tx.description}`);
  console.log(`  Status: ${tx.status}, Fee: $${tx.fee}`);
});

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth/token

Query Parameters

​
page
integer
default:1

Page number

Required range: x >= 1
​
perPage
integer
default:50

Items per page (max 100)

Required range: 1 <= x <= 100
​
type
enum<string>

Filter by transaction type

Available options:
CREDIT,
DEBIT
​
status
enum<string>

Filter by status

Available options:
PENDING,
COMPLETED,
FAILED

Response

Transactions retrieved successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
​
data
object
​
meta
object