Ctrl+K

Get transaction information

get/api/v2/{coin}/admin/tx/{txId}

Path Parameters

  • txIdstringRequired
    Min length: >= 1 characters
  • coinstringRequired
    A cryptocurrency symbol or token ticker symbol
    Example: btc
    Min length: >= 1 characters

200 Response

transfers array[object] 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.
Example: 2000000
Match pattern: ^-?\d+$
coin string required
A cryptocurrency symbol or token ticker symbol
Example: btc
comment
string or null
A comment from the user
date string <date-time>required
The date this Transfer was last updated
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
organization string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
bitgoOrg string
Allowed values: 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 array[object] required
An array of objects describing the change in address balances made as a result of this Transfer
history array[object] required
An audit log of events that have happened to the Transfer during its lifecycle
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
pendingApproval string
state string 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. - `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.
Allowed values: initialized pendingApproval rejected signed unconfirmed confirmed removed failed replaced deleted
stakingParams object
txid string
The on-chain transaction id
Example: b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26
type string required
Defines whether or not this Transfer was sent or received by the user
Allowed values: send receive
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
Example: 2000000
Match pattern: ^-?\d+$
wallet string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletType string
Wallet type
Allowed values: backing cold custodial custodialPaired hot advanced trading
replaces array[string]
Transaction IDs that this transfer replaces.
replacedBy array[string]
Transaction IDs that replace this transfer.
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
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
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 string
Transfer subtype
Allowed values: 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 receive_from_gastank reserved_amount utxo_message_signing pending_deposit 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
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 array[object]
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 array[object]
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 array[object]
Additional metadata associated with the transfer
sendAccounting array[object]
Accounting breakdown for send transactions
tags array[string]
The tags to be used on this Transfer (used in Policies)
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)
sendQueue array[object] required
debugTa2Ta
coin string required
A cryptocurrency symbol or token ticker symbol
Example: btc
token string
state string required
The status of this SendQueue item
Allowed values: pending attempted failed done reverted held replaced abandoned
Example: done
user string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
wallet string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
address string
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
pendingApprovalId string
createTime number required
Number of milliseconds since January 1, 1970
Example: 1537289808000
modifyTime number required
Number of milliseconds since January 1, 1970
Example: 1537289808000
expireTime number
submitHeight number
confirmHeight number
comment string
txType string
txid string required
The on-chain transaction ID
Example: b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26
tx string required
Raw transaction (hex)
value number
The total value (in base units) sent by this sendq transaction
valueString string required
The total value (in base units) sent by this sendq transaction represented as a String
Example: 200000
Match pattern: ^-?\d+$
payGoFee number required
The Transfer's BitGo fee (in base units)
payGoFeeString string required
The Transfer's BitGo fee (in base units) represented as a String
attempts number required
Number of transmission attempts
targetAttempts number required
Max number of times to try transmitting
nextAttempt required
instantId string
instant boolean
Use instant sending (coin-specific) method if available
agent required
error string
Error regarding the transaction
held boolean required
Indicates that the transaction was held at some point
uniqueDoubleSpendPreventionIds array[string] required
Example: ["59cd72485007a239fb00282ed480da1f"]
coinSpecificOne ofrequired
Transaction fields specific to each coin type
deployment boolean required
lowPriority boolean
feesUsed required
firstValidBlock number
lastValidBlock number
customNode object
txRequestId string <uuid>
Example: 123e4567-e89b-12d3-a456-426614174000
sendQueueUnconfirmedInputs array[object] required
debugTa2Ta
coin string required
A cryptocurrency symbol or token ticker symbol
Example: btc
token string
state string required
The status of this SendQueue item
Allowed values: pending attempted failed done reverted held replaced abandoned
Example: done
user string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
wallet string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
address string
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
pendingApprovalId string
createTime number required
Number of milliseconds since January 1, 1970
Example: 1537289808000
modifyTime number required
Number of milliseconds since January 1, 1970
Example: 1537289808000
expireTime number
submitHeight number
confirmHeight number
comment string
txType string
txid string required
The on-chain transaction ID
Example: b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26
tx string required
Raw transaction (hex)
value number
The total value (in base units) sent by this sendq transaction
valueString string required
The total value (in base units) sent by this sendq transaction represented as a String
Example: 200000
Match pattern: ^-?\d+$
payGoFee number required
The Transfer's BitGo fee (in base units)
payGoFeeString string required
The Transfer's BitGo fee (in base units) represented as a String
attempts number required
Number of transmission attempts
targetAttempts number required
Max number of times to try transmitting
nextAttempt required
instantId string
instant boolean
Use instant sending (coin-specific) method if available
agent required
error string
Error regarding the transaction
held boolean required
Indicates that the transaction was held at some point
uniqueDoubleSpendPreventionIds array[string] required
Example: ["59cd72485007a239fb00282ed480da1f"]
coinSpecificOne ofrequired
Transaction fields specific to each coin type
deployment boolean required
lowPriority boolean
feesUsed required
firstValidBlock number
lastValidBlock number
customNode object
txRequestId string <uuid>
Example: 123e4567-e89b-12d3-a456-426614174000
txRequestsrequired
intentOne of
The intent of the transaction request
unsignedTxs array[object]
Holds all unsigned transactions that will be used to fulfill the TxRequest for MPC wallets.
signatureShares array[object]
Only used for MPC coins. This is used to collect signature shares from and exchange them with the user.
commitmentShares array[object]
Only used for MPC coins on EdDSA curve. This is used to collect commitment shares from and exchange them with the user.
txHashes array[string]
The hashes of all transactions from the TxRequest that have been signed and are pending broadcast.
apiVersion string
The API version of the transaction request
Allowed values: lite full
txRequestId string <uuid>required
A unique ID for the TxRequest document across all wallets. The combination of the txRequestId and version will always be unique.
Example: 123e4567-e89b-12d3-a456-426614174000
idempotencyKey string
The idempotency key of the transaction request
walletId string required
The id of the Wallet the TxRequest is for.
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletType string
The type describes who owns the keys to the wallet associated to the TxRequest.
Allowed values: backing cold custodial custodialPaired hot advanced trading
version number required
The version of the transaction request
enterpriseId string
If the wallet that owns the TxRequest is owned by an enterprise then this is the Id of said enterprise.
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
state string required
Allowed values: pendingApproval canceled rejected initialized pendingDelivery delivered pendingUserSignature pendingUserCommitment pendingUserRShare pendingUserGShare readyToSend signed failed
date string <date-time>required
The date and time this version of the TxRequest document was created.
Example: 2021-01-01T00:00:00.000Z
createdDate string <date-time>required
The date and time the version 1 TxRequest document was created.
Example: 2021-01-01T00:00:00.000Z
userId string required
The Id of the User that produced this version of the TxRequest document. Could have created a new document or updated an existing document.
initiatedBy string required
The Id of the User that originally created the TxRequest document (initiated the TxRequest).
updatedBy string required
The Id of the User that last updated the TxRequest document. This is an alias for the userId field.
intents array required
pendingApprovalId string
The id of the Pending Approval that was created for the TxRequest if one was required.
policiesChecked boolean
latest boolean required
Indicates if this is the latest transaction request
isCanceled boolean
True, if the transaction request is canceled.
pendingApprovals array[object] required
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
coin string
A cryptocurrency or token ticker symbol.
Example: btc
wallet string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletType string
wallets array[string]
The wallets of the pending approval
Example: 59cd72485007a239fb00282ed480da1f
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
organization string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
organizationName string
The organization name
bitgoOrg string
The BitGo organization
creator string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
createDate string <date-time>required
The creation date of the pending approval
approvedDate string <date-time>
The date when the approval was granted
updatedAt string <date-time>
The date when the approval was last updated (any update, not just processing)
keyCurve string
The key curve of the coin attached to this pending approval
Allowed values: secp256k1 ed25519 bls12_381
info object required
Information about the pending approval
stateOne ofrequired
The state of the pending approval
Allowed values: pending awaitingSignature pendingFinalApproval pendingCustodianApproval pendingVideoApproval pendingIdVerification pendingLivenessVerification pendingManualTrustReview pendingManualSupportReview pendingVideoApprovalFromSupport
scope string required
What kind of entity the Pending Approval is tied to
Allowed values: enterprise wallet organization global
userIds array[string]
All the Users who should see this Pending Approval
approvalsRequired number
Minimum: >= 1
Example: 1
walletLabel string
Label for the wallet
addressLabels array[object]
Address labels of recipients in this Pending Approval
resolvers array[object]
Resolvers for the pending approval
approvers array[string]
List of approvers
singleRunResults array[object]
Results from single run checks
txRequestId string <uuid>
Transaction request ID
Example: 123e4567-e89b-12d3-a456-426614174000
videoId object
ID for the video related to the approval
version number
Version of the pending approval
policyEvaluationId string
ID for the policy evaluation
actions array[object]
List of actions taken
resolutionOrder array[object]
Order of resolution
useLegacyPolicyEngine boolean
Flag to use legacy policy engine
videoCallId string
ID for the video call
lastUpdated string <date-time>
The last date the approval was processing
freeze object
The freeze state
associatedInquiries array[object]
Associated inquiries

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id