---
updatedAt: 2026-05-07T12:29:32.000Z
agentTools:
  projectIndex: https://docs.utila.io/llms.txt
---

# ListWalletAddresses

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

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Utila API",
    "version": "v2"
  },
  "tags": [
    {
      "name": "Wallets"
    }
  ],
  "paths": {
    "/v2/vaults/{vault_id}/wallets/{wallet_id}/addresses": {
      "get": {
        "summary": "ListWalletAddresses",
        "description": "Retrieve a list of all wallet addresses of a specific wallet.",
        "operationId": "Wallets_ListWalletAddresses",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v2ListWalletAddressesResponse"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "vault_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "wallet_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageSize",
            "description": "The maximum number of items to return. The service may return fewer than this value.\n\nIf unspecified, at most 50 will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageToken",
            "description": "A page token, received from the previous list call as `nextPageToken`.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter",
            "description": "A filter expression that filters wallet addresses listed in the response.\n\nSupported fields and functions:\n| Name | Description | Example |\n|------|-------------|---------|\n| `address` | Filter by one or more on-chain addresses (`string...`). | `address(\"0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6\")` |\n| `network` | Filter by one or more networks (`string...`). | `network(\"networks/ethereum-mainnet\")` |\n\nTip: combine a wildcard wallet (`-`) in the parent with the `address` filter to look up\naddresses across all wallets in a vault.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "skip",
            "description": "How many results to skip.\n\nNote: may be used alongside token-based pagination (see `pageToken`),\nalthough this won't be needed for most use cases.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "tags": [
          "Wallets"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.utila.io"
    }
  ],
  "components": {
    "schemas": {
      "BTCDetailsAddressFormat": {
        "type": "string",
        "enum": [
          "P2PKH",
          "P2WPKH",
          "P2TR"
        ],
        "description": "Address format for a Bitcoin-based network. Subset of\nWalletAddress.Format restricted to Bitcoin-based values."
      },
      "v2ListWalletAddressesResponse": {
        "type": "object",
        "properties": {
          "walletAddresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v2WalletAddress"
            },
            "description": "The addresses returned."
          },
          "nextPageToken": {
            "type": "string",
            "description": "A token, which can be sent as `pageToken` to retrieve the next page.\nIf this field is omitted, there are no subsequent pages."
          },
          "totalSize": {
            "type": "integer",
            "format": "int32",
            "description": "Total number of items in the response, regardless of pagination."
          }
        },
        "description": "The response message for ListAddresses."
      },
      "v2WalletAddress": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "vaults/1b25635a5b3f/wallets/67af44031584/addresses/519c67ddae33",
            "description": "The resource name of the WalletAddress.\n\nFormat: `vaults/{vault_id}/wallets/{wallet_id}/addresses/{address_id}`",
            "readOnly": true
          },
          "displayName": {
            "type": "string",
            "example": "Hal's Address 3",
            "description": "A human-readable name.\nRelevant only for deposit addresses.\n\nMust match the regular expression `[a-zA-Z0-9\\.,:\\-'# _$]+$` and be shorter than 100 characters"
          },
          "network": {
            "type": "string",
            "example": "networks/bitcoin-mainnet",
            "description": "The resource name of the network of the address.\n\nFormat: `networks/{network_id}`"
          },
          "address": {
            "type": "string",
            "example": "bc1q04pum57enmfgcu3tu5gwqlmza5n7tchky0gjvu",
            "description": "The blockchain address.",
            "readOnly": true
          },
          "format": {
            "example": "BITCOIN_P2WPKH",
            "description": "Address format.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/v2WalletAddressFormat"
              }
            ]
          },
          "key": {
            "type": "string",
            "example": "vaults/1b25635a5b3f/keys/95257c5a522f",
            "description": "The resource name of the MPC key this address was derived from.\n\nFormat: `vaults/{vault_id}/keys/{key_id}`",
            "readOnly": true
          },
          "keyDerivationPath": {
            "type": "array",
            "example": [
              44,
              0,
              0,
              0,
              3
            ],
            "items": {
              "type": "string",
              "format": "int64"
            },
            "description": "Derivation path of the address from the MPC key.",
            "readOnly": true
          },
          "type": {
            "example": "DEPOSIT",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/v2WalletAddressType"
              }
            ]
          },
          "note": {
            "type": "string",
            "example": "This is a note",
            "title": "note"
          },
          "createParams": {
            "description": "Parameters only used during wallet address creation. Not included in\nresponses.",
            "allOf": [
              {
                "$ref": "#/components/schemas/v2WalletAddressCreateParams"
              }
            ]
          }
        },
        "required": [
          "network"
        ]
      },
      "v2WalletAddressCreateParams": {
        "type": "object",
        "properties": {
          "btcDetails": {
            "description": "Bitcoin-specific creation parameters.",
            "allOf": [
              {
                "$ref": "#/components/schemas/v2WalletAddressCreateParamsBTCDetails"
              }
            ]
          }
        },
        "description": "Parameters only used during wallet address creation."
      },
      "v2WalletAddressCreateParamsBTCDetails": {
        "type": "object",
        "properties": {
          "format": {
            "example": "P2TR",
            "description": "Address format for the new address.\n\nOnly valid when the wallet has no address on this network yet (i.e.\nwhen this request adds the network to the wallet); once a wallet has\nan address on a Bitcoin-based network, every further address uses the\nsame format, and a mismatching value is rejected.\n\nPer-chain supported formats and defaults are listed in the create\nparams of `CreateWallet`.\n\nSetting this for a non-Bitcoin-based network is an error.",
            "allOf": [
              {
                "$ref": "#/components/schemas/BTCDetailsAddressFormat"
              }
            ]
          }
        },
        "description": "Bitcoin-specific creation parameters.",
        "required": [
          "format"
        ]
      },
      "v2WalletAddressFormat": {
        "type": "string",
        "enum": [
          "BITCOIN_P2PKH",
          "BITCOIN_P2WPKH",
          "EVM",
          "TRON_BASE58",
          "BASE58",
          "TON_NON_BOUNCEABLE",
          "SUBSTRATE_58",
          "BITCOIN_P2TR"
        ],
        "description": " - BITCOIN_P2PKH: Bitcoin P2PKH address format.\n - BITCOIN_P2WPKH: Bitcoin P2WPKH address format.\n - EVM: Ethereum address format.\n - TRON_BASE58: Tron base58 address format.\n - BASE58: Solana address format.\n - TON_NON_BOUNCEABLE: Ton address format.\n - SUBSTRATE_58: Substrate address format.\n - BITCOIN_P2TR: Bitcoin P2TR (Taproot, BIP-341) address format."
      },
      "v2WalletAddressType": {
        "type": "string",
        "enum": [
          "MAIN",
          "DEPOSIT",
          "CHANGE"
        ],
        "description": " - MAIN: Main address (main address of the wallet).\n - DEPOSIT: Deposit address.\n - CHANGE: Change address."
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```