Ctrl+K

List wallet shares

get/api/v2/walletshares

List shares of all wallets with other BitGo users. Returns only wallets on which the current user has spend permission.

200 Response

incoming array[object]
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
coin string required
A cryptocurrency or token ticker symbol.
Example: btc
wallet string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletLabel string required
Example: My Wallet
fromUser string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
toUser string required
A cryptocurrency or token ticker symbol.
Example: btc
permission string
Comma-separated list of privileges for a wallet. Includes: - 'admin' - Can manage wallet policies and users and approve or reject pending approvals. - 'freeze' - Can freeze a wallet, disabling all withdrawals. - 'spend' - Can initiate withdrawals and generate new receive addresses. - 'trade' - Can initiate trades from a Go Account ('trading' wallet type). - 'view' - Can view balances and transactions. Permissions don't overlap. Required parameter if 'reshare' is false.
Allowed values: admin spend trade view
Example: spend,view
message string required
User readable message to display to the share recipient
state string required
Allowed values: pendingapproval active accepted canceled rejected
Example: active
enterprise string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
pendingApprovalId string
Only set if this wallet share is currently pending approval
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
keychain object
Only set if this wallet share has an associated keychain
outgoing array[object]
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
coin string required
A cryptocurrency or token ticker symbol.
Example: btc
wallet string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletLabel string required
Example: My Wallet
fromUser string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
toUser string required
A cryptocurrency or token ticker symbol.
Example: btc
permission string
Comma-separated list of privileges for a wallet. Includes: - 'admin' - Can manage wallet policies and users and approve or reject pending approvals. - 'freeze' - Can freeze a wallet, disabling all withdrawals. - 'spend' - Can initiate withdrawals and generate new receive addresses. - 'trade' - Can initiate trades from a Go Account ('trading' wallet type). - 'view' - Can view balances and transactions. Permissions don't overlap. Required parameter if 'reshare' is false.
Allowed values: admin spend trade view
Example: spend,view
message string required
User readable message to display to the share recipient
state string required
Allowed values: pendingapproval active accepted canceled rejected
Example: active
enterprise string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
pendingApprovalId string
Only set if this wallet share is currently pending approval
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
keychain object
Only set if this wallet share has an associated keychain