Skip to main content
GET
/
wallets
/
{walletId}
/
transfers
/
{transferId}
Get Transfer
curl --request GET \
  --url https://api.dfns.io/wallets/{walletId}/transfers/{transferId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "xfr-20g4k-nsdpo-mg6arrifgvid4orn",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Native",
    "to": "<string>",
    "amount": "<string>",
    "memo": "<string>",
    "priority": "Slow",
    "createDestinationAccount": true,
    "offer": true,
    "expiresAt": "2023-11-07T05:31:56Z",
    "externalId": "<string>",
    "travelRule": {
      "kind": "Notabene",
      "originator": {},
      "beneficiary": {},
      "beneficiaryVASPdid": "<string>",
      "beneficiaryProof": {}
    },
    "feeSponsorId": "<string>"
  },
  "metadata": {
    "asset": {
      "symbol": "<string>",
      "decimals": 123,
      "verified": true,
      "quotes": {
        "EUR": 123,
        "USD": 123
      }
    }
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "approvalId": "<string>",
  "externalId": "<string>",
  "feeSponsorId": "fs-5vqdl-gliqk-b4rfukqauov1sp7j"
}

​
Authentication

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

​
Required Permissions

Wallets:Transfers: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
Minimum string length: 1
​
transferId
string
required
Minimum string length: 1

Response

200 - application/json

Success

​
id
string
required

Transfer id.

Required string length: 1 - 64
Example:

"xfr-20g4k-nsdpo-mg6arrifgvid4orn"

​
walletId
string
required

The source wallet for this tranfer.

Required string length: 1 - 64
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

​
network
enum<string>
required

The blockchain network this transfer is on.

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,
Ethereum,
EthereumClassic,
EthereumClassicMordor,
EthereumGoerli,
EthereumSepolia,
EthereumHolesky,
EthereumHoodi,
FantomOpera,
FantomTestnet,
FlareC,
FlareCCoston2,
FlowEvm,
FlowEvmTestnet,
Hedera,
HederaTestnet,
Ink,
InkSepolia,
InternetComputer,
Ion,
IonTestnet,
Iota,
IotaTestnet,
Kaspa,
Kusama,
KusamaAssetHub,
Litecoin,
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,
TempoAndantino,
Tsc,
TscTestnet1,
Ton,
TonTestnet,
Tron,
TronNile,
Westend,
WestendAssetHub,
XrpLedger,
XrpLedgerTestnet
​
requester
object
required

The user (including Service Accounts) who requested this transfer.

​
requestBody
Native Asset · object
required

Transfer the native token of the network. All networks support the native token type.

​
metadata
object
required

Additional metadata about the transfered asset.

​
status
enum<string>
required

Transfer status.

StatusDefinition
PendingThe request is pending approval due to a policy applied to the wallet.
ExecutingThe request is approved and is in the process of being executed. note this status is only set for a short time between pending and broadcasted.
BroadcastedThe transaction has been successfully written to the mempool.
ConfirmedThe transaction has been confirmed on-chain by our indexing pipeline.
FailedIndicates either system failure to complete the request or the transaction failed on chain.
RejectedThe request has been rejected by a policy approval action.
Available options:
Pending,
Executing,
Broadcasted,
Confirmed,
Failed,
Rejected
​
dateRequested
string<date-time>
required

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

Example:

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

​
reason
string

The reason for a failed transfer.

​
txHash
string

The blockchain transaction hash for this transfer.

​
fee
string

The fee paid for this transfer in minimum denomination.

​
datePolicyResolved
string<date-time>

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

Example:

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

​
dateBroadcasted
string<date-time>

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

Example:

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

​
dateConfirmed
string<date-time>

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

Example:

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

​
approvalId
string

The id of the approval request if this transfer triggered a policy.

​
externalId
string

The external id provided at transfer creation time.

​
feeSponsorId
string

The fee sponsor id used to pay for the transfer fees.

Required string length: 1 - 64
Example:

"fs-5vqdl-gliqk-b4rfukqauov1sp7j"