Ctrl+K

List wallets

get/api/v2/wallets

Lists all wallets you can access, including:

  • Wallets you have a role on (admin, spender, or viewer).
  • Wallets in enterprises you belong to that have the 'View All Wallets' option enabled from the enterprise settings.

Query Parameters

  • idarray[string]
    Filter by ID
    Example: "\"59cd72485007a239fb00282ed480da1f\""
    Pattern: ^[0-9a-f]{32}$
    Min length: >= 1 characters
  • coinarray[string]
    Filter by coin
    Example: "\"btc\""
  • enterprisearray[string]
    Filter by enterprise.
    Example: "\"59cd72485007a239fb00282ed480da1f\""
    Pattern: ^[0-9a-f]{32}$
  • typearray[string]
    Filter by wallet type
  • deletedstring
    Filter by deleted state
    Enum: true false
  • prevIdstring
    Return the next batch of results, based on the "nextBatchPrevId" value from the previous batch.
    Example: "59cd72485007a239fb00282ed480da1f"
    Pattern: ^[0-9a-f]{32}$
  • labelContainsstring
    Filter by label substring.
  • expandBalancestringDefault: false
    Add "balanceString", "confirmedBalanceString" and "spendableBalanceString" to each wallet
    Enum: true false
  • excludeSpendableBalancestring
    Enum: true false
  • expandPolicystring
    Enum: true false
  • expandCustodialWalletstring
    Whether linked custodial wallets should be expanded inline
    Enum: true false
  • ignoreErrorsstring
    Enum: true false
  • limitstring<number>Default: 25
    Maximum number of results to return. If the result set is truncated, use the "nextBatchPrevId" value to get the next batch.
  • offsetstring<number>Default: 0
    Number of documents to skip for offset-based pagination.
  • skipReceiveAddressstringDefault: false
    Do not add "receiveAddress" to each wallet
    Enum: true false
  • permissionstring
    Return only wallets for which the user has the given permission
    Enum: admin view spend
  • pinnedWalletsstring
    Enum: pinnedOnly pinnedExcluded

200 Response

coinOne of
wallets array[object] required
allowBackupKeySigning boolean required
approvalsRequired number required
Minimum: >= 1
Example: 1
coin string required
A cryptocurrency symbol or token ticker symbol
Example: btc
coinSpecific required
deleted boolean required
disableTransactionNotifications boolean required
hasLargeNumberOfAddresses boolean required
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
isCold boolean required
label string required
Example: My Wallet
startDate string <date-time>required
Wallet creation time
admin object
billingEnterprise string
buildDefaults object
clientFlags
config
custodialWalletId string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
customChangeKeySignatures object
customerWalletId string
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
organization string
bitgoOrg string
freeze object
instantProvider string
keys array[string]
Example: ["585951a5df8380e0e304a553","585951a5df8380e0e30d645c","585951a5df8380e0e30b6147"]
keySignatures object
m number
Number of signatures required. This value must be 2 for hot wallets, 1 for **ofc** wallets, and not specified for custodial wallets.
Example: 2
migratedFrom string
multisigType string
Allowed values: onchain tss blsdkg
multisigTypeVersion string
Allowed value: MPCv2
n number
Number of keys provided. This value must be 3 for hot wallets, 1 for **ofc** wallets, and not specified for custodial wallets.
Example: 3
recoverable boolean
tags array[string]
type string
The type describes who owns the keys to the wallet and how they are stored. "cold" wallets are wallets where the private key of the user key is stored exclusively outside of BitGo's system. "custodial" means that this wallet is a cold wallet where BitGo owns the keys. Only customers of the BitGo Trust can create this kind of wallet. "custodialPaired" means that this is a hot wallet that is owned by the customer but it will be linked to a cold (custodial) wallet where BitGo owns the keys. This option is only available to customers of BitGo Inc. BitGo stores an encrypted private key for the user key of "hot" wallets. "trading" wallets are trading accounts where the coin is "ofc". "distributedCustody" means You manage one key and another key agent manages the second key. BitGo manages the third key
Allowed values: backing cold custodial custodialPaired hot trading
subType string
Allowed values: distributedCustody pairedCustodial
users
walletFlags
balanceString string
The cleared balance of the address in base units (e.g. Satoshis). Guaranteed to not lose precision. The is only returned if the 'expandBalance' query parameter is set to 'true'.
balance number
The cleared balance of the address in base units (e.g. Satoshis). The is only returned if the 'expandBalance' query parameter is set to 'true'.
confirmedBalanceString string
The total balance of confirmed transactions in base units (e.g. Satoshis). The is only returned if the 'expandBalance' query parameter is set to 'true'. Guaranteed to not lose precision.
confirmedBalance number
The total balance of confirmed transactions in base units (e.g. Satoshis). The is only returned if the 'expandBalance' query parameter is set to 'true'.
spendableBalanceString string
The total balance in base units (e.g. Satoshis) which may be used as inputs for creating new transactions in string representation. Guaranteed to not lose precision. The is only returned if the 'expandBalance' query parameter is set to 'true'.
spendableBalance number
The total balance in base units (e.g. Satoshis) which may be used as inputs for creating new transactions in string representation. The is only returned if the 'expandBalance' query parameter is set to 'true'.
nextBatchPrevId string <uuid>
When a result set is truncated, this field returns the id of the last object in the previous batch. To get the next batch of results, pass this value via the "prevId" query parameter.
Example: 585951a5df8380e0e3063e9f
totalCount number

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