---
title: "ListWallets"
method: GET
path: "/v2/vaults/{vault_id}/wallets"
tags: ["Wallets"]
---

# ListWallets

`GET /v2/vaults/{vault_id}/wallets`

Retrieve a list of all wallets in a vault.

## Path parameters

- `vault_id` string, required

## Query parameters

- `view` 'BASIC' | 'FULL'
- `showArchived` boolean
- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string
- `skip` integer
- `includeReferencedResources` boolean

## Response `200`

A successful response.

- V2ListWalletsResponse
  - `wallets` V2Wallet[] — The wallets returned.
    - `name` string — The resource name of the wallet. Format: `vaults/{vault_id}/wallets/{wallet_id}`
    - `displayName` string, required — A human-readable name. Must match the regular expression `[a-zA-Z0-9\.,:\-'# _$]+$` and be shorter than 100 characters
    - `external` boolean — Whether this wallet is external. External wallets are wallets that are not managed by Utila.
    - `archived` boolean — Whether this wallet is archived.
    - `convertedValue` V2ConvertedValue — A message representing a converted value.
      - `amount` string — The amount in USD.
      - `currencyCode` string — The currency code of the amount. Always USD.
    - `hasFrozenAssets` boolean — Some of the assets in this wallet are frozen due to a AML policy. Included only when `FULL` view is requested.
    - `networks` string[], required — The resource names of the networks of the wallet. Can be set during creation and can be added later through the `CreateWalletAddress` method.
    - `evmDetails` V2WalletEVMDetails
      - `address` string — The address of the wallet.
    - `tronDetails` WalletTronDetails
      - `address` string — The address of the wallet.
    - `tonDetails` V2WalletTonDetails
      - `address` string — The address of the wallet.
    - `solanaDetails` WalletSolanaDetails
      - `address` string — The address of the wallet.
    - `xrplDetails` WalletXRPLDetails
      - `signingPubKey` string — The public key of the wallet, hex-encoded as expected by XRPL. For ed25519 keys this starts with `ED`.
    - `createParams` WalletCreateParams — Parameters only used during wallet creation.
      - `walletGroups` string[] — Wallet will be assigned to these wallet groups upon creation. Each group must support assignment of empty wallets on creation in the dedicated group setting. Format: `vaults/{vault_id}/walletGroups/{wallet_group_id}`.
    - `btcDetails` V2WalletBTCDetails
      - `btcNetworkDetails` V2WalletBTCDetailsBTCNetworkDetails[]
        - `network` string — A specific btc network of the wallet.
        - `mainAddress` string — The main deposit address of the wallet in the network.
        - `xpub` string — The xpub of the wallet in the network. Included only when `FULL` view is requested.
  - `nextPageToken` string — A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `totalSize` integer — Total number of items in the response, regardless of pagination.

---

[API](https://skmtc.dev/utila/apis/utila-api.md) · [All operations](https://skmtc.dev/utila/apis/utila-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utila/utila-api/revisions/b4f35b3a1e96/schema)