Skip to main content
GET
/
account
/
statement
Get Statement
curl --request GET \
  --url https://api.fyatu.com/api/v3/account/statement \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Statement retrieved successfully",
  "data": {
    "entries": [
      {
        "transactionId": "TXN-20260115-ABC123",
        "type": "DEBIT",
        "amount": 250,
        "currency": "USD",
        "description": "Payout to customer account",
        "balanceBefore": 5000,
        "balanceAfter": 4750,
        "createdAt": "2026-01-15T14:30:00+00:00"
      },
      {
        "transactionId": "TXN-20260114-DEF456",
        "type": "CREDIT",
        "amount": 1200,
        "currency": "USD",
        "description": "Collection received from customer",
        "balanceBefore": 3800,
        "balanceAfter": 5000,
        "createdAt": "2026-01-14T09:15:00+00:00"
      }
    ],
    "count": 2
  },
  "meta": {
    "requestId": "req_abc123def456",
    "timestamp": "2026-01-15T14:35:00+00:00"
  }
}

Overview

Retrieve the last 100 ledger entries for your business account. Each entry includes the account balance before and after the operation, derived from the immutable double-entry ledger. This endpoint is designed for accounting and reconciliation use cases where you need to verify the exact balance impact of each operation.
For a standard transaction list (category, fee, status, reference), use GET /account/transactions instead. The statement endpoint focuses on balance movements and does not include fee or status details.

Response Fields

FieldTypeDescription
entriesarrayArray of up to 100 ledger entries, newest first
countnumberNumber of entries returned

Entry Fields

FieldTypeDescription
transactionIdstringTransaction batch ID (matches transactionId in /account/transactions)
typestringCREDIT or DEBIT
amountnumberAmount in USD
currencystringAlways USD
descriptionstringLedger description of the operation
balanceBeforenumberAccount balance before this entry (USD)
balanceAfternumberAccount balance after this entry (USD)
createdAtstringISO 8601 timestamp

Example Usage

const response = await fetch('https://api.fyatu.com/api/v3/account/statement', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

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

console.log(`Statement entries: ${data.count}`);
data.entries.forEach(entry => {
  console.log(`${entry.type}: $${entry.amount}${entry.description}`);
  console.log(`  Balance: $${entry.balanceBefore} → $${entry.balanceAfter}`);
});

Use Cases

  1. Reconciliation: Verify the exact balance before and after each operation
  2. Audit trail: Confirm that every debit and credit is accounted for
  3. Balance verification: Cross-check your current balance against the last ledger entry’s balanceAfter

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Response

Statement retrieved successfully

success
boolean
Example:

true

status
integer
Example:

200

message
string
data
object
meta
object