---
title: "List Wallets"
method: GET
path: "/v2/wallet"
---

# List Wallets

`GET /v2/wallet`

List all wallets with pagination. Optionally filter by customer.

## Query parameters

- `page` string, required
- `limit` string, required
- `customerId` string

## Response `200`

- WalletListResponseDto
  - `data` object[], required — Array of wallet objects
    - `id` string, required — The unique identifier of the wallet.
    - `address` string, required — The wallet address on the specified network.
    - `network` 'sol' | 'fogo' | 'ethereum' | 'arbitrum' | 'polygon' | 'base' | 'avalanche' | 'sui' | 'noble' | 'sei' | 'tron' | 'starknet' | 'aptos' | 'hyperliquid', required — The blockchain network for this wallet.
    - `customerId` string, required — The unique identifier of the customer who owns this wallet.
    - `created` string, required — The ISO 8601 timestamp when the wallet was created.
    - `updated` string, required — The ISO 8601 timestamp when the wallet was last updated.
  - `pagination` object, required
    - `page` number, required — Current page number
    - `limit` number, required — Number of items per page
    - `total` number, required — Total number of items
    - `totalPages` number, required — Total number of pages
    - `hasNext` boolean, required — Whether there is a next page
    - `hasPrevious` boolean, required — Whether there is a previous page

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity - Validation Error

---

[API](https://skmtc.net/spherepay/apis/docs-spherepay-co.md) · [All operations](https://skmtc.net/spherepay/apis/docs-spherepay-co/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spherepay/docs-spherepay-co/versions/4f3f5484aed3/schema)