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

# ListWalletAddresses

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

## Request

- Base URL: `https://api.utila.io`
- URL: `https://api.utila.io/v2/vaults/{vault_id}/wallets/{wallet_id}/addresses`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/utila/apis/utila-api/docs/v2/vaults/:vault_id/wallets/:wallet_id/addresses/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of all wallet addresses of a specific wallet.

## Path parameters

- `vault_id` string, required
- `wallet_id` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `filter` string
- `skip` integer

## Response `200`

A successful response.

- V2ListWalletAddressesResponse: The response message for ListAddresses.
  - `walletAddresses` V2WalletAddress[]: The addresses returned.
    - `name` string: The resource name of the WalletAddress. Format: `vaults/{vault_id}/wallets/{wallet_id}/addresses/{address_id}`
    - `displayName` string: A human-readable name. Relevant only for deposit addresses. Must match the regular expression `[a-zA-Z0-9\.,:\-'# _$]+$` and be shorter than 100 characters
    - `network` string, required: The resource name of the network of the address. Format: `networks/{network_id}`
    - `address` string: The blockchain address.
    - `format` 'BITCOIN_P2PKH' | 'BITCOIN_P2WPKH' | 'EVM' | 'TRON_BASE58' | 'BASE58' | 'TON_NON_BOUNCEABLE' | 'SUBSTRATE_58' | 'BITCOIN_P2TR': - BITCOIN_P2PKH: Bitcoin P2PKH address format. - BITCOIN_P2WPKH: Bitcoin P2WPKH address format. - EVM: Ethereum address format. - TRON_BASE58: Tron base58 address format. - BASE58: Solana address format. - TON_NON_BOUNCEABLE: Ton address format. - SUBSTRATE_58: Substrate address format. - BITCOIN_P2TR: Bitcoin P2TR (Taproot, BIP-341) address format.
    - `key` string: The resource name of the MPC key this address was derived from. Format: `vaults/{vault_id}/keys/{key_id}`
    - `keyDerivationPath` string[]: Derivation path of the address from the MPC key.
    - `type` 'MAIN' | 'DEPOSIT' | 'CHANGE': - MAIN: Main address (main address of the wallet). - DEPOSIT: Deposit address. - CHANGE: Change address.
    - `note` string
    - `createParams` V2WalletAddressCreateParams: Parameters only used during wallet address creation.
      - `btcDetails` V2WalletAddressCreateParamsBTCDetails: Bitcoin-specific creation parameters.
        - `format` 'P2PKH' | 'P2WPKH' | 'P2TR', required: Address format for a Bitcoin-based network. Subset of WalletAddress.Format restricted to Bitcoin-based values.
  - `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.

## Changes

- **2026-11-03** `c4a910d79740`: 2 info
  - added the new optional `query` request parameter `filter`
  - added the optional property `walletAddresses/items/createParams` to the response with the `200` status

[Operation history](https://skmtc.dev/utila/apis/utila-api/changes/v2/vaults/:vault_id/wallets/:wallet_id/addresses/get.md)

---

[API](https://skmtc.dev/utila/apis/utila-api.md) - [All operations](https://skmtc.dev/utila/apis/utila-api/llms.txt) - [OpenAPI document](https://skmtc.dev/utila/apis/utila-api/revisions/c4a910d79740?raw)