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": {
    "transactions": [
      {
        "transactionId": "TXN_123456789",
        "reference": "REF_ABC123",
        "amount": 100,
        "currency": "USD",
        "charge": 1.5,
        "status": "COMPLETED",
        "type": "DEBIT",
        "description": "Card funding",
        "balanceBefore": 1600,
        "balanceAfter": 1498.5,
        "createdAt": "2026-01-05T10:30:00+00:00",
        "updatedAt": "2026-01-05T10:30:00+00:00"
      }
    ],
    "pagination": {
      "page": 1,
      "perPage": 50,
      "totalItems": 1,
      "totalPages": 1
    }
  },
  "meta": {
    "requestId": "req_abc123def456",
    "timestamp": "2026-01-05T10:30:00+00:00"
  }
}

​
Overview

Retrieve a paginated list of all transactions on your business account. This includes all debits and credits such as card funding, eSIM purchases, collections, and payouts.

​
Filtering

You can filter transactions by:
ParameterDescription
typeFilter by transaction type: CREDIT or DEBIT
statusFilter by status: PENDING, COMPLETED, or FAILED

​
Pagination

ParameterDefaultMax
page1-
perPage50100

​
Example Usage

const response = await fetch('https://api.fyatu.com/api/v3/account/transactions?page=1&perPage=20&type=DEBIT', {
  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.currency} ${tx.amount} - ${tx.description}`);
});

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