--- title: "List Transactions" method: GET path: "/api/v1/transactions" tags: ["Transactions"] --- # List Transactions `GET /api/v1/transactions` Get a list of all transactions in an organization. ## Query parameters - `page` integer — The page number to fetch. - `size` integer — The number of items per page. - `skip_count` boolean — Whether to skip counting the total number of items. - `created_before` string, date-time - `created_after` string, date-time - `modified_after` string, date-time - `vault_ids` string[] — The filter applies both to transactions that have been signed by the vault and also to transactions that have interacted with the vault. - `chains` string[] - `initiator_ids` string[] - `types` TransactionType[] - `sub_types` TransactionSubType[] - `signer_types` SignerType[] - `user_types` UserType[] - `transaction_ids` string[] - `end_user_ids` string[] - `asset_ids` string[] - `direction` 'outgoing' | 'incoming' - `transaction_hashes` string[] — Transaction hashes to filter by. Will return transactions with any of the specified hashes. The format of the hash depends on the blockchain type. - `search` string — String to search transactions by ID or hash. - `frozen` boolean — Filter for frozen transactions or transactions that were unfrozen. - `claimed` boolean — Filter for transactions waiting for the receiver to claim or accept. `true` selects settled transfers (Stellar claimable balances that were claimed, Canton transfers that were accepted). `false` selects ones not yet settled — still pending receiver action, or (Canton) already expired. - `states` union[] — State of the transaction. Can be one of the following:`aborted` `accelerated` `accelerating` `approved` `canceling` `cancelled` `completed` `completed_reverted` `dropped` `error_processing_by_exchange` `error_pushing_to_blockchain` `error_signing` `error_submitting_to_exchange` `error_submitting_to_provider` `finalized_for_signing` `insufficient_funds` `mined` `mined_reverted` `pending_exchange` `pushed_to_blockchain` `queued` `sent_to_provider` `signed` `stuck` `waiting_for_approval` `waiting_for_signing_trigger`, or an aggregation of states: - union - 'pending' | 'finalized' | 'error' - 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped' - 'waiting_for_approval' | 'approved' | 'signed' | 'completed' | 'aborted' | 'error_signing' | 'error_submitting_to_exchange' | 'pending_exchange' | 'error_processing_by_exchange' - `is_hidden` boolean - `include_full_response` boolean - `batch_ids` string[] - `include_blackbox` boolean - `policy_rule_ids` string[] - `sort_by` TransactionSortableFields[] ## Response `200` Successful Response - ListTransactionResponse - `total` integer, required - `page` integer, required - `size` integer, required - `transactions` Transaction[], required - union - AptosMessage - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `state_changes` NonPushableTransactionStateChange[], required — The state changes of the message. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `type` 'aptos_message', required — Aptos message type. - `aptos_message_type` 'personal_message_type', required - `raw_original_message_to_sign` string, required — The original message that was requested to be signed, encoded in base64. - `string_original_message_to_sign` string, required — The original message that was requested to be signed. - `raw_full_message_to_sign` string, required — The full message to be signed, encoded in base64. - `string_full_message_to_sign` string, required — The full message to be signed. - `chain` EnrichedAptosChain, required - `chain_type` 'aptos', required — The type of the chain. - `unique_id` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `sender` EnrichedAptosAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'aptos', required - `address` string, required — The Aptos address represented in hex format. - AptosTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `type` 'aptos_transaction', required — Aptos transaction type. - `aptos_transaction_type_details` union, required — Details of the Aptos transaction based on its type. - AptosNativeTransferDetails - `type` 'native_transfer', required — A transaction involving the transfer of APT coin from one address to another. - `sender` EnrichedAptosAddress, required - … - `recipient` EnrichedAptosAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - AptosCoinTransferDetails - `type` 'coin_transfer', required — A transaction involving the transfer of non-APT coin from one address to another. - `sender` EnrichedAptosAddress, required - … - `recipient` EnrichedAptosAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - AptosEntryPointDetails - `type` 'entry_point', required — A transaction with an entry point function. - `recipient` EnrichedAptosAddress, required - … - AptosScriptDetails - `type` 'script', required — A transaction with running a move script. - `code` string, required — The code of the script. - `chain` EnrichedAptosChain, required - `chain_type` 'aptos', required — The type of the chain. - `unique_id` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `version` integer — The version of the transaction. - `nonce` integer — The nonce of the transaction. - `sender` EnrichedAptosAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'aptos', required - `address` string, required — The Aptos address represented in hex format. - `payload` union, required — The payload of the transaction. - AptosEntryFunctionPayload - `typed_arguments` string[], required — The typed arguments of the transaction. - `arguments` string[], required — The arguments of the transaction. - `type` 'entry_point', required - `function_id` string, required — The entry function of the transaction. - `address` EnrichedAptosAddress, required - … - `module` string, required — The module of the entry function. - `function_name` string, required — The name of the entry function. - ScriptPayload - `typed_arguments` string[], required — The typed arguments of the transaction. - `arguments` string[], required — The arguments of the transaction. - `type` 'script', required - `code` string, required — The script code of the transaction. - `hash` string — The hash of the transaction. - `gas_submitted` AptosGasData, required - `gas_limit` string, required — The gas limit of the transaction. - `price` AptosGasPrice, required - `priority_level` 'custom' | 'low' | 'medium' | 'high', required - `price` string, required — The price per gas unit (in Octa). - `fiat_price` Price — Price represents a price in a given FiatCurrency. - … - `with_external_fee_payer` boolean — If true, the transaction's Authenticator will be configured to support an external fee payer. After Fordefi signs the transaction, the client is responsible for forwarding it to the designated fee payer for final signing and broadcasting. - `fee_payer` EnrichedAptosAddress - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'aptos', required - `address` string, required — The Aptos address represented in hex format. - `serialized_signed_transaction` string — The serialized signed transaction. - `expected_result` AptosTransactionResult - `reversion` AptosReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value', required - `reason` string — The reason for the reversion (additional information). - `fee_statement` AptosFeeStatement, required - `execution_gas_units` string, required - `io_gas_units` string, required - `storage_fee_octas` string, required - `storage_fee_refund_octas` string, required - `total_charge_gas_units` string, required - `total_gas` string, required — The total gas fee of the transaction (in Octa). - `priced_asset` PricedAsset, required - … - `effects` AptosEffects, required - `balance_changes` AptosBalanceChangeEffect[], required - … - `transfers` AptosTransferEffect[], required - … - `raw_result` string — The raw result of the transaction. - `mined_result` AptosTransactionResult - `reversion` AptosReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value', required - `reason` string — The reason for the reversion (additional information). - `fee_statement` AptosFeeStatement, required - `execution_gas_units` string, required - `io_gas_units` string, required - `storage_fee_octas` string, required - `storage_fee_refund_octas` string, required - `total_charge_gas_units` string, required - `total_gas` string, required — The total gas fee of the transaction (in Octa). - `priced_asset` PricedAsset, required - … - `effects` AptosEffects, required - `balance_changes` AptosBalanceChangeEffect[], required - … - `transfers` AptosTransferEffect[], required - … - `raw_result` string — The raw result of the transaction. - `explorer_url` string, uri — The URL of this transaction in a blockchain explorer. For example, explorer.aptoslabs.com - ArchTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `type` 'arch_transaction', required — The type of the transaction. - `arch_transaction_type_details` union, required — Details of the Arch transaction based on its type. - ArchNativeTransferDetails - `type` 'native_transfer', required — A transaction involving the transfer of native currency from one address to another. - `recipient` EnrichedArchAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - ArchTokenTransferDetails - `type` 'token_transfer', required — A transaction involving the transfer of native currency from one address to another. - `recipient` EnrichedArchAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - ArchRawTransactionDetails - `type` 'raw_transaction', required — A transaction capable of any operation. - `recipients` EnrichedArchAddress[], required — The recipients of the tokens. - … - `chain` EnrichedArchChain, required - `chain_type` 'arch', required — The type of the chain. - `unique_id` 'arch_mainnet' | 'arch_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `instructions` ArchCompiledInstruction[], required — The instructions of the transaction. - `program_index` integer, required — The program index. - `data` string, required — The instruction data in Base64 format. - `account_indexes` integer[], required — The indexes of the instruction accounts in the transaction accounts list. - `program` EnrichedArchAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - … - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - … - `type` 'arch', required - `address` string, required — The Arch address represented in Base58 format. - `base58_data` string — The instruction data encoded in Base58 format. - `accounts` ArchTransactionAccount[], required — Accounts used in the transaction. - `address` EnrichedArchAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - … - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - … - `type` 'arch', required - `address` string, required — The Arch address represented in Base58 format. - `writable` boolean, required — Indicates if this account is writable in the context of the transaction. - `signer` boolean, required — Indicates if this account is a signer of the transaction. - `sender` EnrichedArchAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'arch', required - `address` string, required — The Arch address represented in Base58 format. - `raw_transaction` string — The serialized transaction encoded as a base64 string - `hash` string — The hash of the transaction. - `recent_blockhash` string — The transaction nonce (last block hash). - `expected_result` ArchTransactionResult - `reversion` ArchReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value' | 'insufficient_funds_for_rent', required - `reason` string — The reason for the reversion (additional information). - `transaction_error` string — The description of the error of the transaction. - `fee` ArchFee, required - `base_fee` string, required — The base fee of the transaction (in lamports). - `total_fee` string, required — The total fee of the transaction (in lamports). - `priced_asset` PricedAsset, required - … - `effects` ArchEffects, required - `balance_changes` ArchBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` ArchTransferEffect[], required — The transfer events of the transaction. - … - `mined_result` ArchTransactionResult - `reversion` ArchReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value' | 'insufficient_funds_for_rent', required - `reason` string — The reason for the reversion (additional information). - `transaction_error` string — The description of the error of the transaction. - `fee` ArchFee, required - `base_fee` string, required — The base fee of the transaction (in lamports). - `total_fee` string, required — The total fee of the transaction (in lamports). - `priced_asset` PricedAsset, required - … - `effects` ArchEffects, required - `balance_changes` ArchBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` ArchTransferEffect[], required — The transfer events of the transaction. - … - `explorer_url` string, uri — The URL of this transaction in a blockchain explorer. For example, gomaestro - BlackBoxSignature - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData, required - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `state_changes` NonPushableTransactionStateChange[], required — The state changes of the message. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `type` 'black_box_signature', required — Black Box signature type. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `details` union, required - BlackBoxSignatureEcdsaStarkDetails - `type` 'ecdsa_stark', required — ECDSA over the Stark curve signature. - `signature` EcdsaSignature - … - `hash_binary` string, required — The payload to sign, encoded in base64 format. - BlackBoxSignatureEcdsaSecp256k1Details - `type` 'ecdsa_secp256k1', required — ECDSA over the secp256k1 curve signature. - `signature` EcdsaSignature - … - `hash_binary` string, required — The payload to sign, encoded in base64 format. - BlackBoxSignatureEddsaEd25519Details - `type` 'eddsa_ed25519', required — EDDSA signature. - `signature` string — The signature, encoded in base64 format. - `hash_binary` string, required — The payload to sign, encoded in base64 format. - BlackBoxSignatureSchnorrSecp256k1Details - `type` 'schnorr_secp256k1', required — Schnorr over the secp256k1 curve signature. - `signature` string — The signature, encoded in base64 format. - `hash_binary` string, required — The payload to sign, encoded in base64 format. - CantonTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `type` 'canton_transaction', required — Canton transaction type. - `canton_transaction_type_details` union, required — Details of the Canton transaction based on its type. - CantonNativeTransferDetails - `type` 'native_transfer', required — A transaction involving the transfer of native Canton currency from one address to another. - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the recipient is unknown. - CantonTokenTransferDetails - `type` 'token_transfer', required — A transaction involving the transfer of a CIP-56 token from one address to another. - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the recipient is unknown. - CantonPartyAllocationDetails - `type` 'party_allocation', required — A transaction that allocates an external party on a Canton node. - CantonApproveTransferDetails - `type` 'approve_transfer', required — A transaction that approves pending incoming transfers. - CantonPreApprovalSetupDetails - `type` 'pre_approval_setup', required — A transaction that sets up a transfer pre-approval for auto-accepting incoming transfers. - `asset` PricedAsset, required - … - `chain` EnrichedCantonChain, required - `chain_type` 'canton', required — The type of the chain. - `unique_id` 'canton_mainnet' | 'canton_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `sender` EnrichedCantonAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'canton', required - `address` string, required — The Canton address. - `recipient` EnrichedCantonAddress - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'canton', required - `address` string, required — The Canton address. - `expected_result` CantonTransactionResult - `reversion` CantonReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'insufficient_funds_gas_and_value' | 'unknown_recipient' | 'already_pre_approved', required - `reason` string — The reason for the reversion (additional information). - `effects` CantonEffects, required - `balance_changes` CantonBalanceChangeEffect[], required - … - `transfers` CantonTransferEffect[], required - … - `mined_result` CantonTransactionResult - `reversion` CantonReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'insufficient_funds_gas_and_value' | 'unknown_recipient' | 'already_pre_approved', required - `reason` string — The reason for the reversion (additional information). - `effects` CantonEffects, required - `balance_changes` CantonBalanceChangeEffect[], required - … - `transfers` CantonTransferEffect[], required - … - `memo` string — Optional memo attached to the transfer. - `approval_status` 'requires_approval' | 'approved' | 'expired' - `approval_expires_at` string, date-time — Only set when `approval_status` is `requires_approval`. The sender's `executeBefore` on the pending TransferInstruction — the receiver must accept before this time or the transfer expires. - `hash` string — The on-ledger update id of the transaction. - `explorer_url` string, uri — Link to view the transaction on the block explorer. - CosmosTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `cosmos_transaction_type_details` union, required - CosmosMultipleMessagesTransactionDetails - `transaction_data` union, required - … - `type` 'messages', required — A transaction of multiple messages. - CosmosNativeTransferDetails - `transaction_data` union, required - … - `sender` EnrichedCosmosBechAddress, required - … - `recipient` EnrichedCosmosBechAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - `type` 'native_transfer', required — A transaction involving a native transfer from one address to another. - CosmosTokenTransferDetails - `transaction_data` union, required - … - `sender` EnrichedCosmosBechAddress, required - … - `recipient` EnrichedCosmosBechAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - `type` 'token_transfer', required — A transaction involving a token transfer from one address to another. - `memo` string — Transaction memo. - `chain` EnrichedCosmosChain, required - `chain_type` 'cosmos', required — The type of the chain. - `unique_id` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `base_denom` string, required — The base denom of the chain. - `bech32_prefix` 'agoric' | 'akash' | 'archway' | 'axelar' | 'bbn' | 'celestia' | 'cosmos' | 'dydx' | 'dym' | 'inj' | 'neutron' | 'nillion' | 'noble' | 'osmo' | 'saga' | 'sei' | 'stride' | 'thor' | 'mantra', required - `sender` EnrichedCosmosBechAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'cosmos', required - `address` CosmosBechAddress, required - `type` 'cosmos', required - `chain` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - `address` string, required — The address as bech32. - `hex_repr` string — The hex representation of the address. - `key_type` 'secp256k1' | 'ethsecp256k1' - `type` 'cosmos_transaction', required — The type of the transaction. - `hash` string — The hash of the transaction. - `explorer_url` string, uri — The URL of this transaction in a blockchain explorer. - `signers_info` SignerInfo[], required — List of signers info. - `signer_address` EnrichedCosmosBechAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - … - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - … - `type` 'cosmos', required - `address` CosmosBechAddress, required - … - `public_key` string, required — Public key in its compressed format - `account` string, required — The account number assigned by the chain. - `sequence` string, required — The sequence of this transaction. - `expected_result` CosmosTransactionResult - `message` string — In case of error, the message describes what failed. - `gas_debit` CosmosGasDebit, required - `gas_used` string, required — Gas used while processing the transaction. - `total_fee` CosmosCoinWithAmount[], required — The total fee paid. - … - `fiat_prices` Price[], required — The prices of the coins used to pay the fee. - … - `effects` CosmosEffects, required - `balance_changes` CosmosBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` CosmosTransferEffect[], required — The transfer events of the transaction. - … - `mined_result` CosmosTransactionResult - `message` string — In case of error, the message describes what failed. - `gas_debit` CosmosGasDebit, required - `gas_used` string, required — Gas used while processing the transaction. - `total_fee` CosmosCoinWithAmount[], required — The total fee paid. - … - `fiat_prices` Price[], required — The prices of the coins used to pay the fee. - … - `effects` CosmosEffects, required - `balance_changes` CosmosBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` CosmosTransferEffect[], required — The transfer events of the transaction. - … - `sign_doc` union - AminoSignDoc - `format` 'amino', required - `sign_doc` StdSignDoc, required - … - DirectSignDoc - `format` 'direct', required - `body` string, required — Body bytes, encoded in base64 format. - `auth_info` string, required — Auth info bytes, encoded in base64 format. - `chain` EnrichedCosmosChain, required - … - `account_number` string, required — The account number. - `signed_body` string, required — Actual body bytes that were used when signing the transaction, encoded in base64 format. - `signed_auth_info` string, required — Actual auth info that was used when signing the transaction, encoded in base64 format. - MinedSignDoc - `format` 'mined', required - `messages` string, required — The messages of the transaction. - `chain` EnrichedCosmosChain, required - … - CosmosMessage - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - … truncated; see the full OpenAPI document linked below ## Other responses - `400` — Bad Request - `401` — Unauthorized User - `403` — Forbidden User - `408` — Request Timeout - `422` — Validation Error - `429` — Rate Limit Exceeded - `500` — Unexpected Error --- [API](https://skmtc.net/fordefi/apis/fordefi-api.md) · [All operations](https://skmtc.net/fordefi/apis/fordefi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fordefi/fordefi-api/versions/8014fd69ea17/schema)