Skip to main content
GET
List Wallets
Returns the account’s crypto deposit wallets, newest first. Each item is the full wallet object, the same shape Get Wallet returns. Requires an API key with read access on the accounts scope.

Path Parameters

string
required
The account’s external ID (starts with acct_)

Query Parameters

string
Filter by currency. Must be a currency code the API supports, for example USDC; any other value is rejected with 422.
array
Filter by wallet status. Repeat the key once per value: ?statuses=active&statuses=suspended. Allowed values are active, suspended and deactivated, lowercase; anything else returns 422.
string
Return wallets created on or after this timestamp, inclusive (ISO 8601)
string
Return wallets created before this timestamp, exclusive (ISO 8601)
integer
default:"1"
Page number (minimum 1)
integer
default:"10"
Items per page (1-100)

Response

Items are ordered by creation time, newest first. A wallet is hidden from this list only when the account also holds a wallet for the same currency and network on the provider your organization is currently routed to. The older one is then filtered out and total counts the filtered set, so the number of items can be smaller than the number of wallets on the account. A pair that exists only on the older provider keeps appearing. Being filtered out changes nothing but this list. Funds sent to a filtered-out address are still credited to the account, and Get Wallet still returns the wallet by its id. Keep the ids you already hold.
array
Wallet objects, newest first
integer
Current page number
integer
Items per page
integer
Total number of items across all pages, after the provider filter above
integer
Total number of pages

Errors

Response Example