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

# Balances de puntos

> Obtiene una lista paginada de los balances de puntos de lealtad de los clientes.

Lista de forma paginada los balances de puntos de loyalty de los clientes de la marca autorizada.

Usa este endpoint para exportar o auditar saldos de puntos. Cada fila incluye `clientId`, `justoUserId` cuando existe y `balance`. La data siempre queda limitada al website autorizado por el token de API.


## OpenAPI

````yaml get /royalty/clients-loyalty-balance
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /royalty/clients-loyalty-balance:
    get:
      summary: Balances de puntos
      description: >-
        Obtiene una lista paginada de los balances de puntos de lealtad de los
        clientes.
      parameters:
        - in: query
          name: page
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
            description: Número de página a obtener
        - in: query
          name: pageSize
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
            description: Cantidad de elementos por página
      responses:
        '200':
          description: Lista paginada de balances de puntos de lealtad
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    description: Indica si la operación fue exitosa
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            clientId:
                              type: string
                              example: rty-cli-001
                              description: El ID del cliente
                            justoUserId:
                              type: string
                              example: u-001
                              description: >-
                                El ID del usuario de Justo asociado al cliente,
                                si existe
                              nullable: true
                            balance:
                              type: number
                              example: 150
                              description: >-
                                El balance actual de puntos de lealtad del
                                cliente
                          required:
                            - clientId
                            - justoUserId
                            - balance
                        description: Items de la lista paginada
                      hasNextPage:
                        type: boolean
                        example: false
                        description: Indica si hay una página siguiente
                      hasPreviousPage:
                        type: boolean
                        example: false
                        description: Indica si hay una página anterior
                      totalPages:
                        type: number
                        example: 1
                        description: Total de páginas
                      totalCount:
                        type: number
                        example: 25
                        description: Total de items
                    required:
                      - items
                      - hasNextPage
                      - hasPreviousPage
                      - totalPages
                      - totalCount
                required:
                  - success
                  - data
        '400':
          description: Error de validación
        '401':
          description: No autorizado - token de autenticación inválido o ausente
      security:
        - bearerAuth:
            - admin
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Token

````