---
title: "Movimientos de puntos de lealtad"
method: GET
path: "/royalty/client-point-movements"
---

# Movimientos de puntos de lealtad

`GET /royalty/client-point-movements`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/royalty/client-point-movements`
- Auth: HTTP bearer

Obtiene una lista paginada de los movimientos de puntos de lealtad. Permite filtrar por justoUserId, rango de fechas y tipo de transacción.

## Query parameters

- `justoUserId` string: ID del usuario de Justo
- `startDate` string: Fecha de inicio del rango (formato YYYY-MM-DD o ISO 8601, ej: 2026-01-19 o 2026-01-19T00:00:00Z)
- `endDate` string: Fecha de fin del rango (formato YYYY-MM-DD o ISO 8601, ej: 2026-01-19 o 2026-01-19T23:59:59Z)
- `type` 'manual' | 'redemption' | 'accumulation' | 'referral' | 'expiration' | 'refund': Tipo de movimiento a filtrar
- `page` integer: Número de página a obtener
- `pageSize` integer: Cantidad de elementos por página

## Response `200`

Lista paginada de movimientos de puntos de lealtad

- object
  - `success` boolean, required: Indica si la operación fue exitosa
  - `data` object, required
    - `movements` object[], required: Lista de movimientos de monedas
      - `amount` number, required: Cantidad de puntos de lealtad (positivo para ingresos, negativo para egresos)
      - `userId` string, required: ID del usuario de Justo
      - `createdAt` string, date-time, required: Fecha de creación del movimiento
      - `balance` number, required: Balance de monedas después de este movimiento
      - `direction` 'in' | 'out', required: Dirección del movimiento (in = ingreso, out = egreso)
      - `originReference` object, nullable, required: Referencia del origen del movimiento
        - `type` 'expiration' | 'refund' | 'manual' | 'redemption' | 'accumulation' | 'referral', required: Tipo de origen del movimiento
        - `expiresAt` string, date-time, nullable: Fecha de expiración, si aplica
        - `orderId` string, nullable: ID de la orden, si aplica
        - `orderCode` string, nullable: Código de la orden, si aplica
        - `tabId` string, nullable: ID de la tab (orden presencial), si aplica
        - `description` string, nullable: Descripción del origen del movimiento
    - `pagination` object, required: Información de paginación
      - `totalCount` number, required: Total de movimientos
      - `page` number, required: Página actual
      - `pageSize` number, required: Tamaño de página
      - `totalPages` number, required: Total de páginas
      - `hasNextPage` boolean, required: Indica si hay una página siguiente
      - `hasPreviousPage` boolean, required: Indica si hay una página anterior

## Other responses

- `400`: Error de validación - falta proporcionar justoUserId, formato de fecha inválido, o parámetros de paginación inválidos
- `401`: No autorizado - token de autenticación inválido o ausente
- `404`: Cliente no encontrado

## Changes

- **2026-02-09** `43bab2b2bbb0`: 1 info
  - the `query` request parameter `justoUserId` became optional
- **2026-02-09** `530b4bc771fe`: 2 breaking, 6 warning, 9 info
  - the `query` request parameter `type` was restricted to a list of enum values
  - the `query` request parameter `justoUserId` became required
  - deleted the `query` request parameter `clientId`
  - deleted the `query` request parameter `email`
  - …13 more
- **2026-01-31** `6efab177978c`: 3 info
  - added the new optional `query` request parameter `clientId`
  - added the new optional `query` request parameter `email`
  - the `query` request parameter `justoUserId` became optional
- **2026-01-31** `fd7f4b7f2ecb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/royalty/client-point-movements/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)