| id | string | The ID of the transaction. |
| index | integer | [Optional] Fireblocks’ internal identifier for a specific transfer within a transaction. For UTXO-based assets, this field corresponds to the UTXO’s vOut index. For other blockchains, like EVM, Tron, Solana, etc., this field is derived from the sequential position of the event within the transaction’s transfer list. The field is not returned when the transaction includes multiple destinations. |
| logIndex | integer | Applicable to EVM blockchains only. Represents the EVM log index that indicates the order of the log within the block. This information can be verified directly on the blockchain. |
| blockchainIndex | string | Blockchain-native transfer identifier showing the transfer’s exact position within the block data (e.g., log entry, trace path, or nested array index). - EVM token transfers: Uses logIndex. - EVM internal transfers: Uses traceAddress (e.g., [0,1,2] → “0_1_2”). - Solana: Refers to the nested instruction position in the instruction array. |
| externalTxId | string | Unique transaction ID provided by the user. Fireblocks recommends setting an externalTxId for every transaction created to avoid submitting the same transaction twice. |
| status | string | The current primary status of the transaction. See Primary Transaction Statuses for a detailed list. |
| subStatus | string | [Optional] See Transaction Substatuses for a detailed list of transaction substatuses. |
| txHash | string | The hash of this transaction on the blockchain. txHash is only returned for crypto assets (not fiat) when the operation type is not RAW or TYPED_MESSAGE. This parameter exists if at least one of the following conditions is met: 1. The transaction’s source type is UNKNOWN, WHITELISTED_ADDRESS, ONE_TIME_ADDRESS, FIAT or GAS_STATION. 2. The transaction’s source type is VAULT and the status is CONFIRMING, COMPLETED, or was either status before changing to FAILED or REJECTED. Some transactions with the status BROADCASTING will also include the txHash. 3. The transaction’s source type is EXCHANGE and the transaction’s destination type is VAULT, and the status is: CONFIRMING, COMPLETED, or was either status before changing to FAILED. |
| operation | TransactionOperation | The transaction operation type. The default is TRANSFER. |
| note | string | Custom note that describes this transaction in your Fireblocks workspace. This note is not sent to the blockchain. |
| assetId | string | The ID of the transaction’s asset, for TRANSFER, MINT, BURN, or ENABLE_ASSET operations. See the list of supported assets and their IDs on Fireblocks. |
| assetType | AssetType | One of the following: XLM_ASSET, XDB_ASSET, TRON_TRC20, SOL_ASSET, HBAR_ERC20, FIAT, ERC721, ERC20, ERC1155, BEP20, BASE_ASSET, ALGO_ASSET |
| source | TransferPeerPathResponse | The transaction’s source. |
| sourceAddress | string | If the status is CONFIRMING, COMPLETED, or was CONFIRMING before either FAILED or REJECTED, this parameter will contain only one source address, even if the transaction is a multi-input UTXO. This parameter is empty in any other case. |
| destination | TransferPeerPathResponse | The transaction’s destination. If a transaction is sent to multiple destinations, the destinations parameter is used instead. |
| destinations | Array of DestinationsResponse | For UTXO-based assets. All outputs are specified here. |
| destinationAddress | string | Address where the asset was transferred. For Multi-destination transactions, this parameter will be empty, and you should refer to the destinations field instead. destinationAddress is populated when Fireblocks can determine a single destination address for the transaction (for example, from the transaction request). It is typically available starting from transaction.created for single-destination transfers. For multi-destination transactions (where destinations is used), destinationAddress is empty. In some failure scenarios or before address resolution, this field may also be empty. |
| destinationAddressDescription | string | Description of the address. |
| destinationTag | string | [Optional] Destination address tag for Ripple; destination memo for Cosmos, EOS, Luna, Luna Classic, NEM, Stellar, Hedera, & DigitalBits; destination note for Algorand; bank transfer description for fiat providers. |
| amountInfo | AmountInfo | For TRANSFER operations. All details of the transfer amount. |
| treatAsGrossAmount | boolean | When set to true, the fee is deducted from the requested amount for transactions initiated from this Fireblocks workspace. |
| feeInfo | FeeInfo object | Details of the transaction’s fee. |
| feeCurrency | string | The asset type used to pay the fee (ETH for ERC-20 tokens, BTC for Omni, XLM for Stellar tokens, etc.) |
| networkRecords | Array of NetworkRecord objects | A transaction in Fireblocks can aggregate several blockchain transactions, typically as part of a contract call. Network records specify all intermediate transactions that took place on the blockchain. For single transactions, this parameter is empty. |
| createdAt | number | The transaction’s creation date and time. Shown as a Unix timestamp. |
| lastUpdated | number | The transaction’s last update date and time. Shown as a Unix timestamp. |
| createdBy | string | User ID of the transaction’s initiator. |
| signedBy | Array of strings | User ID(s) of the transaction’s signer(s). |
| rejectedBy | string | User ID of the user who rejected the transaction. Only populated when a transaction is rejected. |
| authorizationInfo | AuthorizationInfo | Data object with information about your Policies. For more about Policies, refer to the Fireblocks Help Center. |
| exchangeTxId | string | If the transaction originated from an exchange, this is the exchange’s ID for this transaction. |
| customerRefId | string | The ID for AML providers to associate the owner of the funds with the transaction. |
| amlScreeningResult | AmlScreeningResult object | The result of the AML screening. |
| replacedTxHash | string | The hash of the replaced transaction. Only populated if this is an RBF transaction on an EVM blockchain. Learn more about RBF transactions. |
| extraParameters | TransactionExtraParameters object | Parameters that are specific to some transaction operation types and blockchain networks. |
| signedMessages | Array of SignedMessage objects | A list of signed messages returned for raw signing. |
| numOfConfirmations | number | The number of blockchain confirmations of the transaction. The number will increase until your workspace’s confirmation policy threshold is satisfied. |
| blockInfo | BlockInfo object | The hash and height of the block in which the transaction was mined. If an outgoing transaction uses the destinations object with more than one value in the array, blockHash is set to null. |
| index | number | [Optional] This field is not returned if a transaction uses the destinations object with more than one value. - For UTXO-based assets, this is the vOut. - For EVM-based, this is the index of the event of the contract call. |
| paidRent | string | The amount of rent paid in SOL to the destination token account. |
| BlockchainInfo | BlockchainInfo object | blockchainInfo is a JSON used to store additional data that is blockchain-specific. For example, in HBAR, it will have the txHash in addition to the txID. |
| rewardsInfo | RewardsInfo object | This field is relevant only for ALGO transactions. Both srcRewrds and destRewards appear only for vault-to-vault transactions. Otherwise, only your workspace side of the transaction is recorded. |
| systemMessages | Array of SystemMessageInfo objects | A response from Fireblocks with details about the health of the current processes. If this object is returned with data, expect potential delays or incomplete transaction statuses. |
| addressType | string | [Optional] Covers all transaction events. |
| requestedAmount (Deprecated) | number | The amount requested by the user. |
| amount (Deprecated) | number | If the transfer is a withdrawal from an exchange, the actual transfer amount; otherwise, the requested amount. |
| netAmount (Deprecated) | number | The net amount of the transfer, after fee deduction. |
| amountUSD (Deprecated) | number | The USD value of the requested amount. |
| serviceFee (Deprecated) | number | The total fee deducted by the exchange from the actual requested amount (serviceFee = amount - netAmount). |
| networkFee (Deprecated) | number | The fee paid to the blockchain network. |
