---
title: "List all wallets linked to your account"
method: GET
path: "/v1/account/wallets"
tags: ["account"]
---

# List all wallets linked to your account

`GET /v1/account/wallets`

Get all wallets linked to your account.

Wallet types:
- **smart_account**: ERC-4337 Smart Account (canonical earning wallet)
- **eoa_embedded**: CDP-provisioned EOA owner key for Smart Account (non-earning)
- **server**: Grove-controlled wallet for sending tips (CDP server wallet)
- **external_linked**: Additional wallets linked via signature verification (non-earning)

Each wallet shows:
- Address and network
- Whether it can earn tips
- Whether it's protected (EOA/smart_account/server wallets cannot be unlinked)
- Verification details

Authentication: `Authorization: Bearer <CLIENT_JWT>`

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove that identifies the account.

## Response `200`

Successful Response

- WalletListResponse — Response model for listing account wallets.
  - `account_id` string, required — Account ID
  - `wallets` WalletResponse[], required — List of wallets linked to the account
    - `id` string, required — Wallet ID
    - `address` string, required — Wallet address
    - `network` string, required — Network (base, base-sepolia, etc.)
    - `wallet_type` string, required — Type of wallet (smart_account, eoa_embedded, server, external_linked)
    - `ens_name` string, nullable — ENS name associated with this wallet (e.g., vitalik.eth)
    - `base_name` string, nullable — Base name associated with this wallet (e.g., jesse.base.eth)
    - `display_name` string, nullable — User-provided display name for the wallet
    - `is_earning_wallet` boolean, required — Whether this wallet can earn tips (true for smart_account wallets)
    - `is_protected` boolean, required — Whether this wallet can be unlinked (EOA/smart_account/server wallets cannot)
    - `verified_at` string, required — When wallet ownership was verified (ISO 8601)
    - `verification_method` string, required — How ownership was verified (signature, cdp_auth, x402_payment)
    - `created_at` string, required — When the wallet was linked (ISO 8601)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/versions/f286b48a8105/schema)