---
title: "Balances de puntos"
method: GET
path: "/royalty/clients-loyalty-balance"
---

# Balances de puntos

`GET /royalty/clients-loyalty-balance`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/royalty/clients-loyalty-balance`
- Auth: HTTP bearer

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

## Query parameters

- `page` integer: Número de página a obtener
- `pageSize` integer: Cantidad de elementos por página

## Response `200`

Lista paginada de balances de puntos de lealtad

- object
  - `success` boolean, required: Indica si la operación fue exitosa
  - `data` object, required
    - `items` object[], required: Items de la lista paginada
      - `clientId` string, required: El ID del cliente
      - `justoUserId` string, nullable, required: El ID del usuario de Justo asociado al cliente, si existe
      - `balance` number, required: El balance actual de puntos de lealtad del cliente
    - `hasNextPage` boolean, required: Indica si hay una página siguiente
    - `hasPreviousPage` boolean, required: Indica si hay una página anterior
    - `totalPages` number, required: Total de páginas
    - `totalCount` number, required: Total de items

## Other responses

- `400`: Error de validación
- `401`: No autorizado - token de autenticación inválido o ausente

## Changes

- **2025-10-21** `b943a476e1fb`: 2 breaking, 8 info
  - removed the media type `application/json` for the response with the status `400`
  - the response property `data/items/items/justoUserId` became nullable for the status `200`
  - added the non-success response with the status `401`
  - the response property `data` became required for the status `200`
  - …6 more
- **2025-09-30** `de3ddd2b3047`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/royalty/clients-loyalty-balance/get.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)