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

````