> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List All Registered Customer Crypto Wallets

> List all wallets with pagination. Optionally filter by customer.

Use this endpoint to retrieve a paginated list of all crypto wallets registered in your SpherePay account. You can optionally filter by customer ID to return only wallets belonging to a specific customer. Results are returned in descending order of creation time.


## OpenAPI

````yaml openapi/spherepay.yaml GET /v2/wallet
openapi: 3.0.0
info:
  contact: {}
  description: The Sphere REST API for payments, transfers, and accounts.
  title: Sphere API
  version: '2'
servers:
  - description: Production
    url: https://api.spherepay.co
security:
  - bearer: []
tags: []
paths:
  /v2/wallet:
    get:
      summary: List Wallets
      description: List all wallets with pagination. Optionally filter by customer.
      operationId: getV2Wallet
      parameters:
        - description: 'Page number of the list (default: 1)'
          in: query
          name: page
          required: true
          schema:
            default: '1'
            example: 1
            type: string
        - description: 'Number of items per page (default: 10)'
          in: query
          name: limit
          required: true
          schema:
            default: '10'
            example: 10
            type: string
        - description: Filter by customer ID
          in: query
          name: customerId
          required: false
          schema:
            example: customer_66c4168d418a410eae282b83883bdc39
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletListResponseDto'
          description: ''
        '400':
          content:
            application/json:
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    code: address/invalid
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    detail: Invalid request parameters
                    status: 400
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
          description: Bad Request
        '404':
          content:
            application/json:
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    code: resource/not-found
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    detail: Resource not found
                    status: 404
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
          description: Not Found
        '422':
          content:
            application/json:
              examples:
                Validation Error:
                  summary: Validation Error
                  value:
                    code: validation/failed
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    detail: Validation failed
                    errors:
                      - detail: Invalid email format
                        pointer: /email
                      - detail: Name is required
                        pointer: /name
                    status: 422
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
          description: Unprocessable Entity - Validation Error
components:
  schemas:
    WalletListResponseDto:
      properties:
        data:
          description: Array of wallet objects
          items:
            properties:
              address:
                description: The wallet address on the specified network.
                example: 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
                type: string
              created:
                description: The ISO 8601 timestamp when the wallet was created.
                example: '2025-01-01T00:00:00.000Z'
                type: string
              customerId:
                description: The unique identifier of the customer who owns this wallet.
                example: customer_66c4168d418a410eae282b83883bdc39
                type: string
              id:
                description: The unique identifier of the wallet.
                example: wallet_ce745ef7f3df4b9a8bff1301ce24b045
                type: string
              network:
                description: The blockchain network for this wallet.
                enum:
                  - sol
                  - fogo
                  - ethereum
                  - arbitrum
                  - polygon
                  - base
                  - avalanche
                  - sui
                  - noble
                  - sei
                  - tron
                  - starknet
                  - aptos
                  - hyperliquid
                example: sol
                type: string
              updated:
                description: The ISO 8601 timestamp when the wallet was last updated.
                example: '2025-01-01T00:00:00.000Z'
                type: string
            required:
              - id
              - address
              - network
              - customerId
              - created
              - updated
            type: object
          type: array
        pagination:
          properties:
            hasNext:
              description: Whether there is a next page
              example: false
              type: boolean
            hasPrevious:
              description: Whether there is a previous page
              example: false
              type: boolean
            limit:
              description: Number of items per page
              example: 10
              exclusiveMaximum: false
              exclusiveMinimum: false
              maximum: 100
              minimum: 1
              type: number
            page:
              description: Current page number
              example: 1
              type: number
            total:
              description: Total number of items
              example: 1
              type: number
            totalPages:
              description: Total number of pages
              example: 1
              type: number
          required:
            - page
            - limit
            - total
            - totalPages
            - hasNext
            - hasPrevious
          type: object
      required:
        - data
        - pagination
      type: object
    ProblemDetailsDto:
      properties:
        code:
          type: string
        correlationId:
          type: string
        detail:
          type: string
        errors:
          items:
            properties:
              detail:
                type: string
              header:
                type: string
              parameter:
                type: string
              pointer:
                type: string
            required:
              - detail
            type: object
          type: array
        status:
          type: integer
        title:
          type: string
      required:
        - status
        - detail
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      scheme: bearer
      type: http

````