---
title: "Resumen de lealtad"
method: GET
path: "/royalty/summary"
---

# Resumen de lealtad

`GET /royalty/summary`

## Request

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

Obtiene el resumen de métricas del programa de lealtad: total de clientes, órdenes, puntos emitidos, puntos en circulación y buckets de expiración. Calculado desde las transacciones de los puntos de lealtad. Opcionalmente filtrable por rango de fechas (startDate, endDate).

## Query parameters

- `startDate` string: Fecha de inicio del rango. Formato YYYY-MM-DD (ej. 2026-01-19) o ISO 8601 (ej. 2026-01-19T00:00:00Z)
- `endDate` string: Fecha de fin del rango. Formato YYYY-MM-DD o ISO 8601 (ej. 2026-01-19T23:59:59Z)

## Response `200`

Resumen de métricas del programa de lealtad

- object
  - `success` boolean, required: Indica si la operación fue exitosa
  - `data` object, required
    - `totalClients` number, required: Total de clientes con actividad en el programa de lealtad
    - `totalOrders` number, required: Total de órdenes (online + en tienda)
    - `totalOrdersOnline` number, required: Total de órdenes online
    - `totalOrdersInStore` number, required: Total de órdenes en tienda
    - `totalPointsIssued` number, required: Total de puntos emitidos
    - `pointsInCirculation` number, required: Puntos actualmente en circulación (no redimidos ni expirados)
    - `calculatedToDate` string, date-time, required: Fecha de cálculo del resumen
    - `expirationBuckets` object, required: Puntos por rango de días hasta su expiración (menos de 10, 30, 60, 90 días, más de 90, sin expiración)
      - `lessThan10` number, required: Puntos que expiran en menos de 10 días
      - `lessThan30` number, required: Puntos que expiran en menos de 30 días
      - `lessThan60` number, required: Puntos que expiran en menos de 60 días
      - `lessThan90` number, required: Puntos que expiran en menos de 90 días
      - `moreThan90` number, required: Puntos que expiran en más de 90 días
      - `noExpiration` number, required: Puntos sin fecha de expiración

## Other responses

- `400`: Error de validación - formato de fecha inválido en startDate o endDate. Usar YYYY-MM-DD o ISO 8601.
- `401`: No autorizado - token de autenticación inválido o ausente

## Changes

- **2026-02-09** `43bab2b2bbb0`: 1 info
  - endpoint added

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