> ## 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.

# Listar Todas las Billeteras Cripto del Cliente Registradas

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

Usa este endpoint para recuperar una lista paginada de todas las billeteras cripto registradas en tu cuenta de SpherePay. Opcionalmente puedes filtrar por ID de cliente para devolver solo las billeteras pertenecientes a un cliente específico. Los resultados se devuelven en orden descendente de tiempo de creación.


## 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

````