Get all transactions

Overview

The Transactions API allows you to retrieve a comprehensive history of all financial transactions associated with your account. This includes purchases, deposits, withdrawals, transfers, bill payments, and all other financial activities. Endpoint Type: GraphQL Query
Authentication: Required (JWT Bearer Token)
Required Scopes: LIST_PAYMENT AND LIST_PURCHASES
Rate Limit: Standard GraphQL rate limits apply

Quick Start

Basic Query

query GetTransactions {
  getTransactions {
    transactions {
      recordId
      transactionType
      amount
      status
      channel
      connectedAppId
      connectedAppName
      createdAt
    }
    totalCount
    hasNextPage
  }
}

Query Structure

getTransactions(
  filter: TransactionFilterInput
  paginate: OffsetInput
): TransactionConnection!

Parameters

Parameter	Type	Required	Description
`filter`	`TransactionFilterInput`	No	Filtering criteria for transactions
`paginate`	`OffsetInput`	No	Pagination parameters (default: limit=20, offset=0)

Response Structure

TransactionConnection

type TransactionConnection {
  transactions: [Transaction]
  totalCount: Int!
  hasNextPage: Boolean!
}

Field	Type	Description
`transactions`	`[Transaction]`	Array of transaction records
`totalCount`	`Int!`	Total count of transactions matching filter (for pagination)
`hasNextPage`	`Boolean!`	Whether more results are available

TransactionFilterInput

input TransactionFilterInput {
  # Record & Status
  recordId: [UUID]
  status: [TransactionStatus]
  
  # Amount Filters
  amount: Float
  amountGte: Float
  amountLte: Float
  finalAmount: Float
  finalAmountGte: Float
  finalAmountLte: Float
  
  # Cashback Filters
  cashbackAmount: Float
  cashbackAmountGte: Float
  cashbackAmountLte: Float
  cashbackPercentage: Float
  cashbackPercentageGte: Float
  cashbackPercentageLte: Float
  
  # Fee Filters
  feeAmount: Float
  feeAmountGte: Float
  feeAmountLte: Float
  
  # Date Filters
  createdGte: DateTime
  createdLte: DateTime
  updatedGte: DateTime
  updatedLte: DateTime
  
  # Merchant Filters
  merchantId: [UUID]
  merchant: [String]
  
  # Transaction Properties
  transactionType: [String]
  channel: [String!]
  category: [String]
  
  # Virtual Card Filters
  virtualCardProgram: [String]
  virtualCard: [UUID]
  
  # Other
  fundingSource: [String]
  userCashBalanceId: [UUID]
  referenceId: String
  liabilityId: UUID
}

Filter Field Details

Record & Status Filters

`recordId`

Type: [UUID]
Description: Filter by specific transaction record IDs. Example:

filter: {
  recordId: ["550e8400-e29b-41d4-a716-446655440000"]
}

`status`

Type: [TransactionStatus]
Description: Filter by transaction status. Options:

PENDING - Transaction is being processed
SETTLED - Transaction completed successfully

Example:

filter: {
  status: [SETTLED]
}

Amount Filters

`amount`, `amountGte`, `amountLte`

Type: Float
Description: Filter by exact amount or amount range in USD.

amount - Exact amount match
amountGte - Minimum amount (greater than or equal)
amountLte - Maximum amount (less than or equal)

Example:

# Transactions between $10 and $500
filter: {
  amountGte: 10.00
  amountLte: 500.00
}

`finalAmount`, `finalAmountGte`, `finalAmountLte`

Type: Float
Description: Filter by final amount (amount + fees). Example:

filter: {
  finalAmountGte: 25.00
}

Cashback Filters

`cashbackAmount`, `cashbackAmountGte`, `cashbackAmountLte`

Type: Float
Description: Filter by cashback amount earned. Example:

# Transactions that earned $5 or more in cashback
filter: {
  cashbackAmountGte: 5.00
}

`cashbackPercentage`, `cashbackPercentageGte`, `cashbackPercentageLte`

Type: Float
Description: Filter by cashback rate percentage. Example:

# Transactions with 5% or higher cashback
filter: {
  cashbackPercentageGte: 5.0
}

Fee Filters

`feeAmount`, `feeAmountGte`, `feeAmountLte`

Type: Float
Description: Filter by transaction fee amount. Example:

# Transactions with fees
filter: {
  feeAmountGte: 0.01
}

Date Filters

`createdGte`, `createdLte`

Type: DateTime
Format: ISO 8601 (e.g., 2025-01-01T00:00:00Z)
Description: Filter by transaction creation date range. Example:

filter: {
  createdGte: "2025-01-01T00:00:00Z"
  createdLte: "2025-01-31T23:59:59Z"
}

`updatedGte`, `updatedLte`

Type: DateTime
Description: Filter by transaction last update date range.

Merchant Filters

`merchantId`

Type: [UUID]
Description: Filter by specific merchant IDs. Example:

filter: {
  merchantId: ["550e8400-e29b-41d4-a716-446655440000"]
}

`merchant`

Type: [String]
Description: Filter by merchant names (matches against destination field). Example:

filter: {
  merchant: ["Amazon", "Walmart"]
}

Transaction Properties

`transactionType`

Type: [String]
Description: Filter by specific transaction types. Common Values:

Add Money - Deposits
Gift Card Purchase - Gift card purchases
Transfer - In - Incoming transfers
Transfer - Out - Outgoing transfers
Virtual Card Purchase - Virtual card purchases
Withdrawal

Example:

filter: {
  transactionType: ["Gift Card Purchase", "Add Money"]
}

`channel`

Type: [String!]
Description: Filter by platform channel. Common Values:

WEB - Web browser
MOBILE - Mobile app
API - API requests

Example:

filter: {
  channel: ["WEB", "MOBILE"]
}

`category`

Type: [String]
Description: Filter by transaction category. Example:

filter: {
  category: ["Shopping", "Travel"]
}

Virtual Card Filters

`virtualCardProgram`

Type: [String]
Description: Filter by virtual card program/issuer. Example:

filter: {
  virtualCardProgram: ["TRANSPECOS", "SUTTON"]
}

`virtualCard`

Type: [UUID]
Description: Filter by specific virtual card IDs. Example:

filter: {
  virtualCard: ["vc-1", "vc-2"]
}

Other Filters

`fundingSource`

Type: [String]
Description: Search for funding source names (partial match on source or destination). Example:

filter: {
  fundingSource: ["Visa"]
}

`referenceId`

Type: String
Description: Filter by external reference ID (e.g., purchase display ID). Example:

filter: {
  referenceId: "1000123"
}

`liabilityId`

Type: UUID
Description: Filter by liability ID (for bill payments).

Pagination

OffsetInput

input OffsetInput {
  limit: Int = 20
  offset: Int = 0
}

Field	Type	Default	Max	Description
`limit`	Int	20	20	Number of transactions to return per page
`offset`	Int	0	-	Number of transactions to skip

Example - Page 1:

paginate: {
  limit: 20
  offset: 0
}

Example - Page 2:

paginate: {
  limit: 20
  offset: 20
}

Example - Check if more pages exist:

query GetTransactions {
  getTransactions(paginate: { limit: 20, offset: 0 }) {
    transactions { recordId }
    hasNextPage  # Use this to determine if there are more results
    totalCount   # Total matching records
  }
}

Transaction Type

type Transaction {
  recordId: UUID
  user: String!
  accountId: UUID!
  userId: UUID
  transactionType: String
  amount: Float!
  destination: String
  source: String
  externalFundingSourceActivity: Float
  fluzBalanceActivity: Float
  fee: Float
  cashback: Float
  
  # Ending balances after transaction
  giftCardPrepaymentBalanceAvailableBalance: Float
  giftCardPrepaymentBalanceTotalBalance: Float
  cashBalanceAvailableBalance: Float
  cashBalanceTotalBalance: Float
  seatBalanceAvailableBalance: Float
  seatBalanceTotalBalance: Float
  reserveBalanceAvailableBalance: Float
  reserveBalanceTotalBalance: Float
  otherCashBalanceAvailableBalance: Float
  otherCashBalanceTotalBalance: Float
  
  status: TransactionStatus
  referenceId: String
  description: String
  note: String
  category: String
  cardLastFour: String
  cardDisplayName: String
  originalCurrencyAmount: Float
  originalCurrencyCode: String
  conversionRate: Float
  merchantId: UUID
  descriptorId: UUID
  virtualCardProgram: String
  cashbackRate: Float
  bonusCashbackRate: Float
  channel: String
  sourceType: String
  logoUrl: String
  platformInstitutionLogo: String
  challengeLogoUrl: String
  invitedAccountId: UUID
  expectedClearedDate: DateTime
  liabilityId: UUID
  isGiftCardBalanceAffected: Boolean
  isCashBalanceAffected: Boolean
  isSeatBalanceAffected: Boolean
  isReserveBalanceAffected: Boolean
  transferId: UUID
  usedUserCashBalanceId: UUID
  connectedAppId: UUID
  connectedAppName: String
  
  memo: String
  transactionCategory: String
  attachmentUrl: String

  createdAt: DateTime
  updatedAt: DateTime
}

Field Descriptions

Core Transaction Fields

Field	Type	Description
`recordId`	UUID	Unique identifier for this transaction record
`user`	String	Display name of the user associated with transaction
`accountId`	UUID	Account that owns this transaction
`userId`	UUID	User who initiated the transaction
`transactionType`	String	Type of transaction (PURCHASE, DEPOSIT, etc.)
`amount`	Float	Primary transaction amount in USD
`source`	String	Where the funds came from (e.g., “Bank Card ****1234”)
`destination`	String	Where the funds went (e.g., merchant name)
`status`	TransactionStatus	Current status (PENDING or SETTLED)

Financial Details

Field	Type	Description
`externalFundingSourceActivity`	Float	Change to external funding sources (bank cards/accounts)
`fluzBalanceActivity`	Float	Change to Fluz internal balances
`fee`	Float	Fees charged for this transaction
`cashback`	Float	Cashback earned from this transaction
`cashbackRate`	Float	Cashback rate percentage
`bonusCashbackRate`	Float	Additional bonus cashback rate

Balance Snapshots

Important: All balance fields show the balance after this transaction was applied.

Field	Description
`cashBalanceAvailableBalance`	Available cash balance after transaction
`cashBalanceTotalBalance`	Total cash balance after transaction
`seatBalanceAvailableBalance`	Available rewards balance after transaction
`seatBalanceTotalBalance`	Total rewards balance after transaction
`giftCardPrepaymentBalanceAvailableBalance`	Available prepayment balance after transaction
`giftCardPrepaymentBalanceTotalBalance`	Total prepayment balance after transaction
`reserveBalanceAvailableBalance`	Available reserve balance after transaction
`reserveBalanceTotalBalance`	Total reserve balance after transaction
`otherCashBalanceAvailableBalance`	Other cash available balance after transaction
`otherCashBalanceTotalBalance`	Other cash total balance after transaction

Transaction Details

Field	Type	Description
`referenceId`	String	External reference (e.g., purchase display ID)
`description`	String	Human-readable description
`note`	String	Additional notes
`category`	String	Transaction category
`cardLastFour`	String	Last 4 digits of card used (if applicable)
`cardDisplayName`	String	Display name of payment method
`memo`	String	A free-text memo attached to this transaction. Set via `updateTransactionMetadata` or at transaction time on deposits, purchases, and transfers.
`transactionCategory`	String	Category label attached to this transaction. Set via `updateTransactionMetadata` or at transaction time on deposits, purchases, and transfers.
`attachmentUrl`	String	A signed URL for the file attached to this transaction. Set via `updateTransactionMetadata` or at transaction time. This URL expires — do not store it. Re-fetch the transaction when you need to access the file.

Merchant Information

Field	Type	Description
`merchantId`	UUID	Merchant identifier
`descriptorId`	UUID	Transaction descriptor ID
`logoUrl`	String	URL to merchant/source logo

Virtual Card Information

Field	Type	Description
`virtualCardProgram`	String	Virtual card program (LITHIC, MARQETA, etc.)

Currency Conversion

Field	Type	Description
`originalCurrencyAmount`	Float	The amount the card issuer reports as requested, in minor units of the merchant’s currency (`6300` HKD is 63.00 HKD). On a return it is the amount still on hold before that return, so reconcile on `amount`
`originalCurrencyCode`	String	Original currency code (e.g., “EUR”)
`conversionRate`	Float	Exchange rate applied

Metadata

Field	Type	Description
`channel`	String	Platform channel (WEB, MOBILE, API)
`sourceType`	String	Type of funding source
`liabilityId`	UUID	Associated liability (for bill payments)
`transferId`	UUID	Associated transfer (for P2P)
`usedUserCashBalanceId`	UUID	Specific cash balance used
`isGiftCardBalanceAffected`	Boolean	Whether gift card balance changed
`isCashBalanceAffected`	Boolean	Whether cash balance changed
`isSeatBalanceAffected`	Boolean	Whether rewards balance changed
`isReserveBalanceAffected`	Boolean	Whether reserve balance changed
`connectedAppId`	UUID	Associated application ID
`connectedAppName`	String	Associated application name
`createdAt`	DateTime	When transaction was created
`updatedAt`	DateTime	When transaction was last updated

Examples

Example 1: Basic Transaction List

Query:

query GetRecentTransactions {
  getTransactions(
    paginate: { limit: 10, offset: 0 }
  ) {
    transactions {
      recordId
      transactionType
      amount
      description
      status
      cashback
      createdAt
    }
    totalCount
    hasNextPage
  }
}

Response:

{
  "data": {
    "getTransactions": {
      "transactions": [
        {
          "recordId": "550e8400-e29b-41d4-a716-446655440000",
          "transactionType": "GIFT_CARD_PURCHASE",
          "amount": 50.00,
          "description": "Gift card purchase at Amazon",
          "status": "SETTLED",
          "cashback": 2.50,
          "createdAt": "2025-01-15T14:30:00Z"
        },
        {
          "recordId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
          "transactionType": "DEPOSIT",
          "amount": 100.00,
          "description": "Cash Balance Deposit",
          "status": "SETTLED",
          "cashback": 0.00,
          "createdAt": "2025-01-14T10:15:00Z"
        }
      ],
      "totalCount": 2,
      "hasNextPage": false
    }
  }
}

Example 2: Filtered by Date Range

Query:

query GetJanuaryTransactions {
  getTransactions(
    filter: {
      createdGte: "2025-01-01T00:00:00Z"
      createdLte: "2025-01-31T23:59:59Z"
    }
    paginate: { limit: 20, offset: 0 }
  ) {
    transactions {
      recordId
      transactionType
      amount
      description
      status
      createdAt
    }
    totalCount
    hasNextPage
  }
}

Example 3: Purchases Only with Balances

Query:

query GetPurchaseHistory {
  getTransactions(
    filter: {
      transactionType: ["GIFT_CARD_PURCHASE"]
      status: [SETTLED]
    }
    paginate: { limit: 20, offset: 0 }
  ) {
    transactions {
      recordId
      referenceId
      amount
      description
      source
      destination
      cashback
      cashbackRate
      cashBalanceAvailableBalance
      seatBalanceAvailableBalance
      createdAt
    }
    totalCount
    hasNextPage
  }
}

Response:

{
  "data": {
    "getTransactions": {
      "transactions": [
        {
          "recordId": "550e8400-e29b-41d4-a716-446655440000",
          "referenceId": "1000123",
          "amount": 50.00,
          "description": "Gift card purchase at Amazon",
          "source": "Visa ****1234",
          "destination": "Amazon",
          "cashback": 2.50,
          "cashbackRate": 5.0,
          "cashBalanceAvailableBalance": 102.50,
          "seatBalanceAvailableBalance": 25.00,
          "createdAt": "2025-01-15T14:30:00Z"
        }
      ],
      "totalCount": 1,
      "hasNextPage": false
    }
  }
}

Example 4: High-Cashback Transactions

Query:

query GetHighCashbackTransactions {
  getTransactions(
    filter: {
      cashbackPercentageGte: 5.0
      status: [SETTLED]
    }
    paginate: { limit: 10, offset: 0 }
  ) {
    transactions {
      recordId
      transactionType
      amount
      description
      cashback
      cashbackRate
      status
      createdAt
    }
    totalCount
  }
}

Example 5: Amount Range Filter

Query:

query GetMediumTransactions {
  getTransactions(
    filter: {
      amountGte: 50.00
      amountLte: 200.00
      status: [SETTLED]
    }
    paginate: { limit: 20, offset: 0 }
  ) {
    transactions {
      recordId
      amount
      transactionType
      description
      createdAt
    }
    totalCount
    hasNextPage
  }
}

Example 6: Virtual Card Transactions

Query:

query GetVirtualCardTransactions {
  getTransactions(
    filter: {
      virtualCardProgram: ["LITHIC", "MARQETA"]
    }
    paginate: { limit: 20, offset: 0 }
  ) {
    transactions {
      recordId
      amount
      description
      virtualCardProgram
      merchantId
      status
      createdAt
    }
    totalCount
  }
}

Example 7: Pagination Example

Query - Get first page and check for more:

query GetFirstPage {
  getTransactions(paginate: { limit: 20, offset: 0 }) {
    transactions {
      recordId
      amount
      transactionType
    }
    totalCount
    hasNextPage
  }
}

Response shows hasNextPage=true:

{
  "data": {
    "getTransactions": {
      "transactions": [...],
      "totalCount": 150,
      "hasNextPage": true
    }
  }
}

Query - Get second page:

query GetSecondPage {
  getTransactions(paginate: { limit: 20, offset: 20 }) {
    transactions {
      recordId
      amount
      transactionType
    }
    totalCount
    hasNextPage
  }
}

Error Handling

Common Errors

Missing or Invalid Token

{
  "errors": [
    {
      "message": "Authentication required",
      "extensions": {
        "code": "UNAUTHENTICATED"
      }
    }
  ]
}

HTTP Status: 401 Unauthorized

Insufficient Permissions

{
  "errors": [
    {
      "message": "Insufficient permissions: LIST_PAYMENT and LIST_PURCHASES scopes required",
      "extensions": {
        "code": "FORBIDDEN",
        "requiredScopes": ["LIST_PAYMENT", "LIST_PURCHASES"]
      }
    }
  ]
}

HTTP Status: 403 Forbidden

Invalid Filter Parameters

{
  "errors": [
    {
      "message": "Invalid date format for createdGte",
      "extensions": {
        "code": "BAD_USER_INPUT"
      }
    }
  ]
}

HTTP Status: 400 Bad Request

Rate Limit Exceeded

{
  "message": "Rate limit exceeded"
}

HTTP Status: 429 Too Many Requests This is a plain JSON body, not a GraphQL errors array. See Rate limits for how long the block lasts.

Best Practices

1. Use Pagination Effectively

Always check hasNextPage to determine if more results exist:

async function fetchAllTransactions() {
  const allTransactions = [];
  let offset = 0;
  const limit = 20;
  
  while (true) {
    const result = await getTransactions({ 
      paginate: { limit, offset } 
    });
    
    allTransactions.push(...result.transactions);
    
    if (!result.hasNextPage) break;
    offset += limit;
  }
  
  return allTransactions;
}

2. Request Only Needed Fields

Specify only the fields you need to reduce response size:

# Good - minimal fields
getTransactions {
  transactions {
    recordId
    amount
    transactionType
    createdAt
  }
  totalCount
  hasNextPage
}

# Less efficient - requesting all 40+ fields
getTransactions {
  transactions {
    recordId
    transactionType
    amount
    ... (all fields)
  }
}

3. Use Date Filters for Historical Queries

When querying older transactions, always use date filters:

# Good
filter: {
  createdGte: "2024-01-01T00:00:00Z"
  createdLte: "2024-12-31T23:59:59Z"
}

4. Cache Settled Transactions

Transactions with status: SETTLED are immutable and can be cached:

// Example caching strategy
const cacheKey = `transactions:${accountId}:${createdGte}:${createdLte}`;
let result = cache.get(cacheKey);

if (!result) {
  result = await getTransactions({
    filter: { status: ['SETTLED'], createdGte, createdLte }
  });
  cache.set(cacheKey, result, '1 hour');
}

5. Combine Filters Efficiently

Use range filters to narrow results before applying other filters:

# Efficient - date range first
filter: {
  createdGte: "2025-01-01T00:00:00Z"
  createdLte: "2025-01-31T23:59:59Z"
  transactionType: ["GIFT_CARD_PURCHASE"]
  amountGte: 50.00
}

Rate Limits

This query shares the GraphQL API’s limits. See Rate limits for the numbers and what a rejected request looks like.

Code Examples

JavaScript/TypeScript

import { ApolloClient, InMemoryCache, gql } from '@apollo/client';

const client = new ApolloClient({
  uri: 'https://transactional-graph.fluzapp.com/api/v1/graphql',
  cache: new InMemoryCache(),
  headers: {
    authorization: `Bearer ${accessToken}`,
  },
});

const GET_TRANSACTIONS = gql`
  query GetTransactions($filter: TransactionFilterInput, $paginate: OffsetInput) {
    getTransactions(filter: $filter, paginate: $paginate) {
      transactions {
        recordId
        transactionType
        amount
        description
        status
        cashback
        createdAt
      }
      totalCount
      hasNextPage
    }
  }
`;

async function fetchTransactions() {
  const { data } = await client.query({
    query: GET_TRANSACTIONS,
    variables: {
      filter: {
        status: ['SETTLED'],
        createdGte: '2025-01-01T00:00:00Z',
      },
      paginate: {
        limit: 20,
        offset: 0,
      },
    },
  });
  
  return data.getTransactions;
}

Python

import requests

def get_transactions(access_token, created_gte=None, created_lte=None, limit=20, offset=0):
    url = "https://transactional-graph.fluzapp.com/api/v1/graphql"
    
    query = """
        query GetTransactions($filter: TransactionFilterInput, $paginate: OffsetInput) {
            getTransactions(filter: $filter, paginate: $paginate) {
                transactions {
                    recordId
                    transactionType
                    amount
                    description
                    status
                    cashback
                    createdAt
                }
                totalCount
                hasNextPage
            }
        }
    """
    
    variables = {
        "filter": {},
        "paginate": {
            "limit": limit,
            "offset": offset
        }
    }
    
    if created_gte:
        variables["filter"]["createdGte"] = created_gte
    if created_lte:
        variables["filter"]["createdLte"] = created_lte
    
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json"
    }
    
    response = requests.post(
        url,
        json={"query": query, "variables": variables},
        headers=headers
    )
    
    return response.json()["data"]["getTransactions"]

# Usage
result = get_transactions(
    access_token="your_token_here",
    created_gte="2025-01-01T00:00:00Z",
    limit=20
)

print(f"Found {result['totalCount']} transactions")
print(f"Has more pages: {result['hasNextPage']}")

cURL

curl -X POST https://transactional-graph.fluzapp.com/api/v1/graphql \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query GetTransactions($filter: TransactionFilterInput, $paginate: OffsetInput) { getTransactions(filter: $filter, paginate: $paginate) { transactions { recordId transactionType amount description status cashback createdAt } totalCount hasNextPage } }",
    "variables": {
      "filter": {
        "status": ["SETTLED"],
        "createdGte": "2025-01-01T00:00:00Z"
      },
      "paginate": {
        "limit": 20,
        "offset": 0
      }
    }
  }'

FAQ

Q: What’s the maximum number of transactions I can retrieve in one request?

A: The maximum limit is 20 transactions per request. Use the hasNextPage field to implement pagination.

Q: How far back does transaction history go?

A: All transactions from account creation are available indefinitely.

Q: Are pending transactions included?

A: Yes, pending transactions are included by default. Filter by status: [SETTLED] to exclude them.

Q: What timezone are the timestamps in?

A: All timestamps are in UTC (ISO 8601 format).

Q: What scopes do I need?

A: You need both LIST_PAYMENT AND LIST_PURCHASES scopes.

Q: Can I filter by user ID within my account?

A: No, the API always returns all transactions for your account. There is no user-level filtering.

Q: What’s the difference between `amount` and `finalAmount` filters?

amount filters the base transaction amount
finalAmount filters amount + fees (the total charged to the user)

Q: How do I filter by date range?

A: Use createdGte and createdLte for creation date:

filter: {
  createdGte: "2025-01-01T00:00:00Z"
  createdLte: "2025-01-31T23:59:59Z"
}

Support

API Status: https://status.fluz.app
Developer Portal: https://developers.fluz.app
Support Email: api-support@fluz.app
Slack Community: https://fluz-dev.slack.com

Changelog

v1.0.0 (Branch: 13-fluz-15659-add-transactions-query-and-webhook-to-api)

Initial release of Transactions Query API
Support for comprehensive filtering (15+ filter types)
Pagination with TransactionConnection response type
Balance snapshots included in transaction records
Requires LIST_PAYMENT and LIST_PURCHASES scopes
Account-level transaction access only

Need help? Contact our developer support team at api-support@fluz.app or visit our Developer Portal.

​Overview

​Quick Start

​Basic Query

​Query Structure

​Parameters

​Response Structure

​TransactionConnection

​Filter Options

​TransactionFilterInput

​Filter Field Details

​Record & Status Filters

recordId

status

​Amount Filters

amount, amountGte, amountLte

finalAmount, finalAmountGte, finalAmountLte

​Cashback Filters

cashbackAmount, cashbackAmountGte, cashbackAmountLte

cashbackPercentage, cashbackPercentageGte, cashbackPercentageLte

​Fee Filters

feeAmount, feeAmountGte, feeAmountLte

​Date Filters

createdGte, createdLte

updatedGte, updatedLte

​Merchant Filters

merchantId

merchant

​Transaction Properties

transactionType

channel

category

​Virtual Card Filters

virtualCardProgram

virtualCard

​Other Filters

fundingSource

referenceId

liabilityId

​Pagination

​OffsetInput

​Transaction Type

​Field Descriptions

​Core Transaction Fields

​Financial Details

​Balance Snapshots

​Transaction Details

​Merchant Information

​Virtual Card Information

​Currency Conversion

​Metadata

​Examples

​Example 1: Basic Transaction List

​Example 2: Filtered by Date Range

​Example 3: Purchases Only with Balances

​Example 4: High-Cashback Transactions

​Example 5: Amount Range Filter

​Example 6: Virtual Card Transactions

​Example 7: Pagination Example

​Error Handling

​Common Errors

​Missing or Invalid Token

​Insufficient Permissions

​Invalid Filter Parameters

​Rate Limit Exceeded

​Best Practices

​1. Use Pagination Effectively

​2. Request Only Needed Fields

​3. Use Date Filters for Historical Queries

​4. Cache Settled Transactions

​5. Combine Filters Efficiently

​Rate Limits

​Code Examples

​JavaScript/TypeScript

​Python

​cURL

​FAQ

​Q: What’s the maximum number of transactions I can retrieve in one request?

​Q: How far back does transaction history go?

​Q: Are pending transactions included?

​Q: What timezone are the timestamps in?

Overview

Quick Start

Basic Query

Query Structure

Parameters

Response Structure

TransactionConnection

Filter Options

TransactionFilterInput

Filter Field Details

Record & Status Filters

`recordId`

`status`

Amount Filters

`amount`, `amountGte`, `amountLte`

`finalAmount`, `finalAmountGte`, `finalAmountLte`

Cashback Filters

`cashbackAmount`, `cashbackAmountGte`, `cashbackAmountLte`

`cashbackPercentage`, `cashbackPercentageGte`, `cashbackPercentageLte`

Fee Filters

`feeAmount`, `feeAmountGte`, `feeAmountLte`

Date Filters

`createdGte`, `createdLte`

`updatedGte`, `updatedLte`

Merchant Filters

`merchantId`

`merchant`

Transaction Properties

`transactionType`

`channel`

`category`

Virtual Card Filters

`virtualCardProgram`

`virtualCard`

Other Filters

`fundingSource`

`referenceId`

`liabilityId`

Pagination

OffsetInput

Transaction Type

Field Descriptions

Core Transaction Fields

Financial Details

Balance Snapshots

Transaction Details

Merchant Information

Virtual Card Information

Currency Conversion

Metadata

Examples

Example 1: Basic Transaction List

Example 2: Filtered by Date Range

Example 3: Purchases Only with Balances

Example 4: High-Cashback Transactions

Example 5: Amount Range Filter

Example 6: Virtual Card Transactions

Example 7: Pagination Example

Error Handling

Common Errors

Missing or Invalid Token

Insufficient Permissions

Invalid Filter Parameters

Rate Limit Exceeded

Best Practices

1. Use Pagination Effectively

2. Request Only Needed Fields

3. Use Date Filters for Historical Queries

4. Cache Settled Transactions

5. Combine Filters Efficiently

Rate Limits

Code Examples

JavaScript/TypeScript

Python

cURL

FAQ

Q: What’s the maximum number of transactions I can retrieve in one request?

Q: How far back does transaction history go?

Q: Are pending transactions included?

Q: What timezone are the timestamps in?