Skip to main content
GET
/
wallets
/
{walletId}
/
transactions
/
{transactionId}
Get Transaction
curl --request GET \
  --url https://api.dfns.io/wallets/{walletId}/transactions/{transactionId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Transaction",
    "transaction": "<string>",
    "externalId": "<string>"
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "externalId": "<string>"
}

​
Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Wallets:Transactions:Read: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

​
walletId
string
required

Wallet id.

Required string length: 1 - 64
​
transactionId
string
required

Transaction id.

Required string length: 1 - 64

Response

200 - application/json

Success

​
id
string
required

Transaction id.

Required string length: 1 - 64
Pattern: ^tx-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"tx-583hu-sp2p7-slvb9nqpa3hd8bus"

​
walletId
string
required

Wallet id.

Required string length: 1 - 64
Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

​
network
enum<string>
required
Available options:
Algorand,
AlgorandTestnet,
Aptos,
AptosTestnet,
ArbitrumOne,
ArbitrumSepolia,
ArcTestnet,
AvalancheC,
AvalancheCFuji,
BabylonGenesis,
BabylonTestnet5,
Base,
BaseSepolia,
Berachain,
BerachainBepolia,
Bitcoin,
BitcoinSignet,
BitcoinTestnet3,
BitcoinCash,
Bob,
BobSepolia,
Bsc,
BscTestnet,
Canton,
CantonTestnet,
Cardano,
CardanoPreprod,
Concordium,
ConcordiumTestnet,
Celo,
CeloAlfajores,
Codex,
CodexSepolia,
CosmosHub4,
CosmosIcsTestnet,
Dogecoin,
DogecoinTestnet,
Ethereum,
EthereumClassic,
EthereumClassicMordor,
EthereumSepolia,
EthereumHolesky,
EthereumHoodi,
FantomOpera,
FantomTestnet,
FlareC,
FlareCCoston2,
FlowEvm,
FlowEvmTestnet,
Hedera,
HederaTestnet,
Ink,
InkSepolia,
InternetComputer,
Ion,
IonTestnet,
Iota,
IotaTestnet,
Kaspa,
Kusama,
KusamaAssetHub,
Litecoin,
LitecoinTestnet,
Near,
NearTestnet,
Optimism,
OptimismSepolia,
Origyn,
Plasma,
PlasmaTestnet,
Plume,
PlumeSepolia,
Paseo,
PaseoAssetHub,
Polkadot,
PolkadotAssetHub,
Polygon,
PolygonAmoy,
Polymesh,
PolymeshTestnet,
Race,
RaceSepolia,
SeiAtlantic2,
SeiPacific1,
Solana,
SolanaDevnet,
Starknet,
StarknetSepolia,
Stellar,
StellarTestnet,
Sui,
SuiTestnet,
Tezos,
TezosGhostnet,
Tempo,
TempoModerato,
Tsc,
TscTestnet1,
Ton,
TonTestnet,
Tron,
TronNile,
Westend,
WestendAssetHub,
XrpLedger,
XrpLedgerTestnet
​
requester
object
required

The user who initiated the request.

​
requestBody
Transaction · object
required

Signs an unsigned transaction and broadcasts it to chain. For EVM transactions, you may use JSON objects:

FieldDescriptionType - Optional
typeEthereum transaction type. 0 for legacy transaction; 2 for EIP-1559 transaction; 4 for EIP-7702 transaction. Default is 2 if undefined.Integer (optional)
toThe destination address or target contract. Leave undefined when the transaction is a contract deployment.String (optional)
valueThe amount of native tokens to transfer in minimum denomination.String (optional)
dataABI encoded function call data in hex format. Can also be the encoded smart contract data when the transaction is a contract deployment.String (optional)
nonceThe transaction number to guarantee idempotency. If omitted, it will be provided automatically. Note the same nonce can be submitted multiple times with a higher maxFeePerGas to "overwrite" existing transactions in the mempool.Integer or String (optional)
gasLimitThe maximum amount of gas that can be spent for executing the transaction. If omitted, it will be calculated automatically.String (optional)
gasPriceThe amount of per unit gas. Only valid for a type 0 legacy transaction. If omitted, it will be calculated automatically.String (optional)
maxFeePerGasThe maximum amount of per unit gas willing to be paid for the transaction. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.String (optional)
maxPriorityFeePerGasThe maximum amount of per unit gas to be included as a tip to the validator. Valid for type 2 and type 4 transactions. If omitted, it will be calculated automatically.String (optional)
authorizationListA list that indicates what code the signer of each authorization desires to execute in the context of their EOA. Only valid for type 4 transaction.Authorization (optional)

For Starknet transactions, you may use invocation request objects (https://github.com/starkware-libs/starknet-specs/blob/v0.8.1/api/starknet_api_openrpc.json#L2621):

FieldDescriptionType - Optional
calldataArray of encoded function call parametersArray of Strings (required)
nonceTransaction nonce in hex formatString (required)
versionTransaction version in hex format. Typically "0x3" for current transactionsString (required)
resourceBoundsGas bounds for L1, L2, and L1 data gasObject (required)
↳ resourceBounds.l1GasL1 gas configuration with maxAmount and maxPricePerUnitObject (required)
↳ resourceBounds.l2GasL2 gas configuration with maxAmount and maxPricePerUnitObject (required)
↳ resourceBounds.l1DataGasL1 data gas configuration with maxAmount and maxPricePerUnitObject (required)
tipTransaction tip in hex format. Typically "0x0"String (required)
paymasterDataPaymaster data arrayArray of Strings (required)
accountDeploymentDataAccount deployment data arrayArray of Strings (required)
nonceDataAvailabilityModeData availability mode for nonce. Typically "L1" for nowString (required)
feeDataAvailabilityModeData availability mode for fee. Typically "L1" for nowString (required)

For Concordium transactions, you may use JSON objects (from https://github.com/Concordium/concordium-node-sdk-js/blob/sdk/12.0.0-alpha.3/packages/sdk/src/transactions/Transaction.ts#L102)

FieldDescriptionType - Optional
HeaderTransaction header for the intermediary state of account transactions, i.e. prior to being signing.Object (required)
↳ Header.executionEnergyAmountThe destination address or target contract. Leave undefined when the transaction is a contract deployment.String/Number/BigInt (required)
↳ Header.numSignaturesThe number of signatures the transaction can hold. If "undefined", this will be defined at the time of signingInteger (optional)
↳ Header.senderThe account address that is source of this transactionString (optional)
↳ Header.nonceThe account nonceString/Number/BigInt (optional)
↳ Header.expiryexpiration of the transactionInteger (optional)
PayloadThe transaction account payload in JSON format (https://github.com/Concordium/concordium-node-sdk-js/blob/main/packages/sdk/src/accountTransactions.ts#L646)Object (required)
{
  "kind": "Transaction",
  "transaction": {
    "to": "0x00fb58432ef9d418bf6688bcf0a226d2fcaa18e2",
    "data": "0x40d097c3000000000000000000000000d2f77f85a50cdd650ca562f3a180284e1d5b4934",
    "maxFeePerGas": "1626000000000",
    "maxPriorityFeePerGas": "1332000000000"
  }
}
{
  "kind": "Transaction",
  "transaction": {
    "type": "INVOKE",
    "calldata": [
      "1",
      "2009894490435840142178314390393166646092438090257831307886760648929397478285",
      "232670485425082704932579856502088130646006032362877466777181098476241604910",
      "3",
      "296727860213112272332383824629975240127004024814636931420022890499591637514",
      "1",
      "0"
    ],
    "nonce": "0x51",
    "version": "0x3",
    "resourceBounds": {
      "l1Gas": { "maxAmount": "0x0", "maxPricePerUnit": "0x239a01ff6e6c" },
      "l2Gas": { "maxAmount": "0x1694a0", "maxPricePerUnit": "0x10c388d00" },
      "l1DataGas": { "maxAmount": "0x120", "maxPricePerUnit": "0x98e8" }
    },
    "tip": "0x0",
    "paymasterData": [],
    "accountDeploymentData": [],
    "nonceDataAvailabilityMode": "L1",
    "feeDataAvailabilityMode": "L1",
  }
}
{
  "kind": "Transaction",
  "transaction": {
    "header": {
      "sender": undefined,
      "nonce": undefined,
      "expiry": undefined,
      "executionEnergyAmount": 300
    },
    "payload": {
      "type": "transferWithMemo",
      "toAddress": "4HhAcToZs6rtxGcgsBRS3VcjeAECPTTSTFVUKS6rBSVEZAPL6d",
      "memo": "000968656c6c6f20636364",
      "amount": "1"
    }
  }
}
​
status
enum<string>
required
Available options:
Pending,
Executing,
Broadcasted,
Confirmed,
Failed,
Rejected
​
dateRequested
string<date-time>
required

ISO 8601 date (must be UTC). When the transaction was requested.

Example:

"2023-04-14T20:41:28.715Z"

​
reason
string
​
txHash
string
​
fee
string
​
approvalId
string
Required string length: 1 - 64
Pattern: ^ap-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"ap-2a9in-tt2a1-983lho480p35ejd0"

​
datePolicyResolved
string<date-time>

ISO 8601 date (must be UTC). When the transaction was approved by policy reviewers.

Example:

"2023-04-14T20:41:28.715Z"

​
dateBroadcasted
string<date-time>

ISO 8601 date (must be UTC). When the transaction was broadcasted to the blockchain.

Example:

"2023-04-14T20:41:28.715Z"

​
dateConfirmed
string<date-time>

ISO 8601 date (must be UTC). When the transaction was confirmed on chain.

Example:

"2023-04-14T20:41:28.715Z"

​
externalId
string
Last modified on February 26, 2026