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

# Balance de puntos de un cliente

> Obtiene el balance de puntos de lealtad de un cliente específico. Se debe proporcionar al menos uno de los siguientes parámetros: justoUserId, clientId o email.

Obtiene el balance actual de puntos de loyalty para un cliente específico de la marca autorizada.

Envía `justoUserId`, `clientId` o `email` para identificar al cliente. La respuesta incluye el cliente, usuario Justo asociado cuando existe, email, balance actual y fecha de última actualización del valor. La búsqueda siempre queda limitada al website autorizado por el token de API.


## OpenAPI

````yaml get /royalty/client-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/client-loyalty-balance:
    get:
      summary: Balance de puntos de un cliente
      description: >-
        Obtiene el balance de puntos de lealtad de un cliente específico. Se
        debe proporcionar al menos uno de los siguientes parámetros:
        justoUserId, clientId o email.
      parameters:
        - in: query
          name: justoUserId
          required: false
          schema:
            type: string
            description: ID del usuario de Justo
        - in: query
          name: clientId
          required: false
          schema:
            type: string
            description: ID del cliente
        - in: query
          name: email
          required: false
          schema:
            type: string
            description: Email del cliente
      responses:
        '200':
          description: Balance de puntos del cliente
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    description: Indica si la operación fue exitosa
                  data:
                    type: object
                    properties:
                      clientId:
                        type: string
                        example: rty-cli-001
                        description: El ID del cliente
                      email:
                        type: string
                        example: cliente@example.com
                        description: El email del cliente, si existe
                        nullable: true
                      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
                      websiteId:
                        type: string
                        example: w-001
                        description: El ID del sitio web al que pertenece el cliente
                      lastUpdated:
                        type: string
                        format: date-time
                        example: '2025-10-14T14:16:11.000Z'
                        description: >-
                          Fecha de la última actualización del balance, si
                          existe
                        nullable: true
                    required:
                      - clientId
                      - email
                      - justoUserId
                      - balance
                      - websiteId
                      - lastUpdated
                required:
                  - success
                  - data
        '400':
          description: >-
            Error de validación - falta proporcionar al menos uno de los
            parámetros requeridos
        '401':
          description: No autorizado - token de autenticación inválido o ausente
        '404':
          description: Cliente no encontrado
      security:
        - bearerAuth:
            - admin
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Token

````