> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Transaction

> Transaction represents a comprehensive record of all account activity including purchases, deposits, withdrawals, transfers, and payouts.

**Object**

Transaction represents a comprehensive record of all account activity including purchases, deposits, withdrawals, transfers, and payouts.

## Fields

<ResponseField name="recordId" type="UUID">
  Unique identifier for the transaction record.
</ResponseField>

<ResponseField name="user" type="String!">
  The display name of the user associated with this transaction.
</ResponseField>

<ResponseField name="accountId" type="UUID!">
  The ID of the account that owns this transaction.
</ResponseField>

<ResponseField name="userId" type="UUID">
  The ID of the user that initiated this transaction.
</ResponseField>

<ResponseField name="transactionType" type="String">
  The type of transaction (e.g., GIFT\_CARD\_PURCHASE, DEPOSIT, WITHDRAWAL, TRANSFER).
</ResponseField>

<ResponseField name="amount" type="Float!">
  The primary transaction amount.
</ResponseField>

<ResponseField name="destination" type="String">
  The destination of the transaction (merchant name, recipient, etc.).
</ResponseField>

<ResponseField name="source" type="String">
  The source of the transaction (funding source, sender, etc.).
</ResponseField>

<ResponseField name="externalFundingSourceActivity" type="Float">
  Activity from external funding sources (bank cards, bank accounts).
</ResponseField>

<ResponseField name="fluzBalanceActivity" type="Float">
  Activity from Fluz internal balances (cash, rewards, prepayment).
</ResponseField>

<ResponseField name="fee" type="Float">
  Transaction fee amount.
</ResponseField>

<ResponseField name="cashback" type="Float">
  Cashback earned from this transaction.
</ResponseField>

<ResponseField name="giftCardPrepaymentBalanceAvailableBalance" type="Float">
  Available balance in gift card prepayment after this transaction.
</ResponseField>

<ResponseField name="giftCardPrepaymentBalanceTotalBalance" type="Float">
  Total balance in gift card prepayment after this transaction.
</ResponseField>

<ResponseField name="cashBalanceAvailableBalance" type="Float">
  Available cash balance after this transaction.
</ResponseField>

<ResponseField name="cashBalanceTotalBalance" type="Float">
  Total cash balance after this transaction.
</ResponseField>

<ResponseField name="seatBalanceAvailableBalance" type="Float">
  Available rewards (seat) balance after this transaction.
</ResponseField>

<ResponseField name="seatBalanceTotalBalance" type="Float">
  Total rewards (seat) balance after this transaction.
</ResponseField>

<ResponseField name="reserveBalanceAvailableBalance" type="Float">
  Available reserve balance after this transaction.
</ResponseField>

<ResponseField name="reserveBalanceTotalBalance" type="Float">
  Total reserve balance after this transaction.
</ResponseField>

<ResponseField name="otherCashBalanceAvailableBalance" type="Float">
  Available balance in other cash accounts after this transaction.
</ResponseField>

<ResponseField name="otherCashBalanceTotalBalance" type="Float">
  Total balance in other cash accounts after this transaction.
</ResponseField>

<ResponseField name="status" type="TransactionStatus">
  Current status of the transaction.
</ResponseField>

<ResponseField name="referenceId" type="String">
  External reference ID (e.g., purchase display ID, deposit ID).
</ResponseField>

<ResponseField name="description" type="String">
  Human-readable description of the transaction.
</ResponseField>

<ResponseField name="note" type="String">
  Additional notes about the transaction.
</ResponseField>

<ResponseField name="category" type="String">
  Transaction category (e.g., Shopping, Travel, Bills).
</ResponseField>

<ResponseField name="cardLastFour" type="String">
  Last four digits of the card used (if applicable).
</ResponseField>

<ResponseField name="cardDisplayName" type="String">
  Display name of the card used (if applicable).
</ResponseField>

<ResponseField name="originalCurrencyAmount" type="Float">
  Original amount in foreign currency (for international transactions).
</ResponseField>

<ResponseField name="originalCurrencyCode" type="String">
  Currency code of the original amount (e.g., EUR, GBP).
</ResponseField>

<ResponseField name="conversionRate" type="Float">
  Currency conversion rate applied.
</ResponseField>

<ResponseField name="merchantId" type="UUID">
  ID of the merchant associated with this transaction.
</ResponseField>

<ResponseField name="descriptorId" type="UUID">
  ID of the transaction descriptor.
</ResponseField>

<ResponseField name="virtualCardProgram" type="String">
  Virtual card program used (e.g., LITHIC, MARQETA, HIGHNOTE\_CFSB).
</ResponseField>

<ResponseField name="cashbackRate" type="Float">
  Cashback rate percentage applied.
</ResponseField>

<ResponseField name="bonusCashbackRate" type="Float">
  Bonus cashback rate percentage applied.
</ResponseField>

<ResponseField name="channel" type="String">
  Channel through which the transaction was initiated.
</ResponseField>

<ResponseField name="sourceType" type="String">
  Type of the funding source used.
</ResponseField>

<ResponseField name="logoUrl" type="String">
  Logo URL for the merchant or source.
</ResponseField>

<ResponseField name="platformInstitutionLogo" type="String">
  Logo URL for the banking institution (for bank-funded transactions).
</ResponseField>

<ResponseField name="challengeLogoUrl" type="String">
  Logo URL for challenges/milestones (for bonus transactions).
</ResponseField>

<ResponseField name="invitedAccountId" type="UUID">
  Account ID of invited user (for referral-related transactions).
</ResponseField>

<ResponseField name="expectedClearedDate" type="DateTime">
  Expected date when pending transaction will be cleared.
</ResponseField>

<ResponseField name="liabilityId" type="UUID">
  ID of associated liability (for bill payments).
</ResponseField>

<ResponseField name="isGiftCardBalanceAffected" type="Boolean">
  Whether this transaction affected the gift card prepayment balance.
</ResponseField>

<ResponseField name="isCashBalanceAffected" type="Boolean">
  Whether this transaction affected the cash balance.
</ResponseField>

<ResponseField name="isSeatBalanceAffected" type="Boolean">
  Whether this transaction affected the rewards (seat) balance.
</ResponseField>

<ResponseField name="isReserveBalanceAffected" type="Boolean">
  Whether this transaction affected the reserve balance.
</ResponseField>

<ResponseField name="transferId" type="UUID">
  ID of the transfer record (for P2P transfers).
</ResponseField>

<ResponseField name="connectedAppId" type="String">
  ID of the application transaction was triggered from
</ResponseField>

<ResponseField name="connectedAppName" type="String">
  Name of the application transaction was triggered from
</ResponseField>

<ResponseField name="usedUserCashBalanceId" type="UUID">
  ID of the specific user cash balance used for this transaction.
</ResponseField>

<ResponseField name="withdrawIds" type="[UUID]">
  IDs of related withdrawals
</ResponseField>

<ResponseField name="createdAt" type="DateTime">
  Timestamp when the transaction was created.
</ResponseField>

<ResponseField name="updatedAt" type="DateTime">
  Timestamp when the transaction was last updated.
</ResponseField>

<ResponseField name="memo" type="String">
  User-defined memo attached to this transaction.
</ResponseField>

<ResponseField name="transactionCategory" type="String">
  User-defined category attached to this transaction.
</ResponseField>

<ResponseField name="attachmentUrl" type="String">
  URL of the attachment associated with this transaction.
</ResponseField>