--- title: "Get Transfer By Approval Id" method: GET path: "/api/v2/pendingapprovals/{approvalId}/transfer" tags: ["Pending approval"] --- # Get Transfer By Approval Id `GET /api/v2/pendingapprovals/{approvalId}/transfer` Route to get transfer by approval id ## Path parameters - `approvalId` string, required ## Response `200` OK - GetTransferByApprovalIdResponse - `transfer` Transfer1, required - `baseValue` number — The value (in base units) sent by this transfer, excluding network fees. BitGo is deprecating this field in the future. - `baseValueString` string — The value (in base units) sent by this transfer, excluding network fees represented as a string. BitGo is deprecating this field in the future. - `coin` string, required — A cryptocurrency symbol or token ticker symbol - `comment` string, nullable — A comment from the user - `date` string, date-time, required — The date this Transfer was last updated - `enterprise` string - `organization` string - `bitgoOrg` 'BitGo Trust' | 'BitGo New York' | 'BitGo Germany' | 'BitGo Switzerland' | 'BitGo Europe ApS' | 'Frankfurt DE Trust' | 'BitGo Singapore' | 'BitGo Korea' | 'BitGo Custody MENA FZE' | 'BitGo India' | 'BitGo Sister Trust 1' | 'BitGo Inc' - `entries` object[], required - `address` string, required — An address affected by this Transfer - `valueString` string — The change (in base units) in the address' balance represented as a string - `isChange` boolean — True if this address is a change address (only exists for UTXO coins) and if this is a "send" transfer - `wallet` string — Only visible when the user has access to the wallet - `walletLabel` string — The label of the wallet referenced by `wallet`. Only visible when the user has access to that wallet. Useful for displaying a human-readable destination name (e.g. for sibling enterprise wallets) instead of a generic external-address fallback. - `value` number — The change (in base units) in the address' balance - `nftSymbol` string - `type` 'flushForwarderTokens' | 'walletFunding' | 'walletInitialization' | 'addressInitialization' | 'importedOutput' | 'onchainidWalletLinked' | 'onchainidClaimAdded' | 'onchainidClaimRemoved' | 'AccountCreateContract' - `isPayGo` boolean — True if this address is the BitGo PayGo wallet - `token` string — If this is a token entry, the token's symbol - `failed` boolean — True if this entry is failed - `associatedNativeCoinAddress` string — The native coin receive address associated with the solana ATA address. This is currently present only for BitGo addresses. This change was done so that there is a mapping between the two addresses in the transfer entries. - `isFee` boolean — Indicates if this entry is a fee - `isInternal` boolean — Indicates if this entry is internal - `memo` string — Memo associated with this entry - `rewardAddress` string — Reward address associated with this entry - `subtype` string — Subtype of this entry - `backingFeeString` string — Backing fee represented as a string - `nftId` string — NFT ID associated with this entry - `tokenContractHash` string — Token contract hash associated with this entry - `isReward` boolean — Indicates if this entry is a reward - `activityMetadata` object — Cosmos group governance metadata (e.g. MsgSubmitProposal details) emitted by the Generic Indexer - `history` object[], required - `action` 'created' | 'approved' | 'rejected' | 'signed' | 'unconfirmed' | 'confirmed' | 'removed' | 'commented' | 'failed' | 'regenerated' | 'replaced' | 'replacing' | 'reversed' | 'abandoned', required - `comment` string, nullable — If this history object is of action "commented", this is the comment from the user - `date` string, date-time, required — The date of this history object - `transferId` string — The ID of the transfer that this history object is associated with - `txid` string — The transaction ID of the transaction that this history object is associated with - `user` string - `id` string, required - `pendingApproval` string - `state` 'initialized' | 'pendingApproval' | 'rejected' | 'signed' | 'unconfirmed' | 'confirmed' | 'removed' | 'failed' | 'replaced' | 'reversed' | 'deleted', required — The state of the transfer. Includes the following: - `confirmed`: The transfer is confirmed on chain. - `failed`: BitGo failed to confirm the transfer on chain. You must retry the transaction. - `initialized`: The initial state when creating a transfer. - `pendingApproval`: The transfer requires admin approval to proceed. - `rejected`: The transfer was rejected by an admin. - `removed`: A network re-org occurred, causing the confirmed transfer to be removed from the blockchain. - `replaced`: The transfer was stuck due to having a low fee and was replaced by a new transfer with a higher fee. - `reversed`: The transfer was reversed (e.g., when a withdrawal offer is rejected in multi-step transfers). - `signed`: The transfer was approved by an admin (if required) and then signed by BitGo. - `unconfirmed`: The signed transaction was sent to the network, and is pending on-chain validation. - `stakingParams` object - `actionType` string, required - `amount` string - `coreDao` object - `amount` string, number, required - `expiration` string, date-time, required - `fee` number, required - `rewardAddress` string, required - `validator` string, required - `version` number, required - `receiverAddress` string - `requestId` string, required - `resource` string - `source` 'external' | 'internal' - `validator` string - `txid` string — The on-chain transaction id - `type` 'send' | 'receive', required - `usd` number — The amount of USD of this Transfer (will be negative if it's a send) - `usdRate` number — The USD rate at the time this Transfer was created - `medianUsdValue` number — The median USD value of this Transfer - `medianUsdRate` number — The median USD rate at the time this Transfer was created - `feeUsd` number — The fee USD value for token transfers - `feeUsdRate` number — The fee coin USD rate for token transfers - `value` number — The total value (in base units) sent by this Transfer (may be approximate for ETH and other coins where amounts in base units can exceed 2^53 - 1) - `valueString` string, required — The total value (in base units) sent by this Transfer represented as a String - `wallet` string, required - `walletType` 'backing' | 'cold' | 'custodial' | 'custodialPaired' | 'hot' | 'advanced' | 'trading' — Wallet type - `replaces` string[] - `replacedBy` string[] - `replacedByTransferId` string[] - `riskIndicators` string[] - `baseValueWithoutFeesString` string — The value (in base units) sent by this transfer, excluding network fees, represented as a string - `baseValueWithoutFees` number — The value (in base units) sent by this transfer excluding network fees. - `coinSpecific` unknown - `confirmations` number — The number of blocks that have been confirmed since this Transfer's block was confirmed - `consolidateId` string — Consolidation ID if this transfer is part of a consolidation - `feeString` string, nullable — The Transfer's fee (in base units) represented as a String - `feeCoin` string — The coin used to pay the fee (for cross-chain transactions) - `sequenceId` string — Unique wallet identifier for preventing double-spends - `subType` 'ofc_deposit' | 'ofc_withdrawal' | 'ofc_book_transfer' | 'ofc_exchange' | 'ofc_bn_settlement_transfer' | 'ofc_bn_allocation' | 'ofc_trading_order' | 'ofc_trading_settlement' | 'ofc_margin_collateral' | 'ofc_margin_position' | 'ofc_direct_trade' | 'ofc_routed' | 'ofc_fee' | 'ofc_other' | 'ofc_unstake' | 'ofc_financing_liquidation' | 'receive_from_gastank' | 'reserved_amount' | 'utxo_message_signing' | 'pending_deposit' | 'pending_deposit_activity' | 'internal_transfer' | 'pending_withdrawal_offer' | 'pending_deposit_offer' | 'offer_accepted' | 'offer_rejected' | 'confirmed_deposit' | 'confirmed_withdrawal' | 'deposit_offer_expired' | 'withdrawal_offer_expired' | 'withdrawal_offer_rejected' | 'utxo_expired' | 'offer_cancelled' | 'cancel_withdrawal_offer' | 'mint_request' | 'mint_offer' | 'mint_accept' | 'mint_deposit' | 'mint_reject' | 'burn_request' | 'burn_offer' | 'burn_accept' | 'burn_withdraw' | 'burn_reject' | 'pending_participant_onboarding_request' | 'participant_onboarding_accepted' | 'pending_dtcc_end_investor_invite' | 'end_investor_invite_offer' | 'end_investor_invite_accepted' | 'end_investor_invite_rejected' | 'pending_allocation' | 'allocation_accepted' | 'cosign_delegation_offer' | 'cosign_delegation_accepted' | 'cash_dvp_settled' | 'repo_dvp_open_leg_settled' | 'repo_dvp_close_leg_settled' | 'staking_eth_withdrawal' | 'staking_eth_partial_withdrawal' | 'staking_eth_full_withdrawal' | 'staking_eth_mev_reward' | 'staking_eth_block_reward' | 'staking_bera_withdrawal' | 'staking_bera_block_reward' | 'defi_deposit' — Transfer subtype - `txRequestId` string — Associated transaction request ID - `goStakingRequestId` string — Associated GO staking request ID - `height` number — The height of the block this Transfer was confirmed in (999999999 if unconfirmed) - `heightId` string — The unique height id of the block - `instant` boolean — Whether this is an instant transaction - `instantId` string — The instant transaction ID if applicable - `isFee` boolean — Whether this transfer represents a fee - `isReward` boolean — Whether this transfer represents a staking reward - `isUnlock` boolean — Whether this transfer represents an unlock operation - `nSegwitInputs` number — DEPRECATED. Number of segwit inputs on the transfer. - `outputs` object[] - `address` string — The address of the UTXO - `blockHeight` number — The block this Unspent was created in - `chain` number — The chain of the UTXO - `coinbase` boolean — True if this unspent came from the coinbase transaction - `id` string — The ID of the UTXO - `index` number — The index of the UTXO - `redeemScript` string — The redeem script of the UTXO - `value` number — The value of the UTXO - `witnessScript` string — The witness script of the UTXO - `payGoFee` number — The Transfer's BitGo fee (in base units) - `payGoFeeString` string — The Transfer's BitGo fee (in base units) represented as a String - `inputs` object[] - `address` string — The address of the UTXO - `blockHeight` number — The block this Unspent was created in - `chain` number — The chain of the UTXO - `coinbase` boolean — True if this unspent came from the coinbase transaction - `id` string — The ID of the UTXO - `index` number — The index of the UTXO - `redeemScript` string — The redeem script of the UTXO - `value` number — The value of the UTXO - `witnessScript` string — The witness script of the UTXO - `intendedValueString` string — A string representation (in base units) of the initial value for the transfer. This is present because when a transaction fails on chain, its value is mutated to be zero. This string is immutable and will always be the intended value of the initial transfer regardless of the final state of the transaction. - `label` string — Address labels (if any) from entries concatenated. - `metadata` object[] - `key` string, required - `value` string, required - `sendAccounting` object[] - `amount` number - `amountString` string, required - `id` string - `nOuts` number, required - `type` string, required - `tags` string[] - `txidType` string — The type of the transaction id - `usersNotified` boolean — Whether BitGo already sent notifications to the users of the transfer wallet - `vSize` number — The size of the transaction - `walletLabel` string — Label of the wallet associated with this transfer - `enterpriseName` string — Name of the enterprise associated with this transfer - `elliptic` string — Elliptic risk score information (trust transfers) - `senderInformationVerified` boolean — Whether sender information has been verified (trust transfers) - `buildParams` object — Parameters used to build the transaction - `createdTime` string, date-time — The time this transfer was created - `approvedTime` string, date-time — The time this transfer was approved - `rejectedTime` string, date-time — The time this transfer was rejected - `signedTime` string, date-time — The time this transfer was signed - `unconfirmedTime` string, date-time — The time this transfer became unconfirmed - `confirmedTime` string, date-time — The time this transfer was confirmed - `removedTime` string, date-time — The time this transfer was removed - `commentedTime` string, date-time — The time this transfer was commented on - `failedTime` string, date-time — The time this transfer failed - `regeneratedTime` string, date-time — The time this transfer was regenerated - `replacedTime` string, date-time — The time this transfer was replaced - `replacingTime` string, date-time — The time this transfer started replacing another - `abandonedTime` string, date-time — The time this transfer was abandoned - `signedDate` string, date-time — The date this transfer was signed (legacy field) - `customerApprovedTime` string, date-time — The time this transfer was approved by the customer (trust transfers) - `idVerificationTime` string, date-time — The time identity verification was completed (trust transfers) - `trustSignedTime` string, date-time — The time this transfer was signed by trust (trust transfers) - `trustFinalApprovalTime` string, date-time — The time this transfer received final trust approval (trust transfers) ## Other responses - `400` — Bad Request - `404` — Not Found --- [API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)