---
title: "Listado paginado de clientes"
method: GET
path: "/royalty/clients"
---

# Listado paginado de clientes

`GET /royalty/clients`

## Request

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

Obtiene una lista paginada de clientes. Opcionalmente se puede ordenar por fecha de creación ascendente mediante el parámetro orderByCreatedAt.

## Query parameters

- `page` integer: Número de página a obtener
- `pageSize` integer: Cantidad de elementos por página
- `filter` string: Filtro de búsqueda sobre los clientes
- `status` string: Filtro por estado del cliente
- `orderByCreatedAt` boolean: Si es true, ordena los resultados por fecha de creación ascendente

## Response `200`

Lista paginada de clientes de royalty

- object
  - `success` boolean, required: Indica si la operación fue exitosa
  - `data` object, required
    - `totalPages` integer, required: Total de páginas
    - `totalCount` integer, required: Total de clientes
    - `hasNextPage` boolean, required: Indica si hay una página siguiente
    - `hasPreviousPage` boolean, required: Indica si hay una página anterior
    - `status` string, required: Estado de la respuesta
    - `items` object[], required: Lista de clientes
      - `_id` string, required: ID del cliente
      - `name` string, required: Nombre del cliente
      - `email` string, required: Email del cliente
      - `phone` string, required: Teléfono del cliente
      - `firstLogin` string, required: Fecha del primer login
      - `lastLogin` string, required: Fecha del último login
      - `ordersCount` number, required: Cantidad de órdenes del cliente
      - `firstOrder` string, required: Fecha de la primera orden
      - `lastOrder` string, required: Fecha de la última orden
      - `pointsBalance` number, required: Balance de puntos de lealtad
      - `marketingEmailEnabled` boolean, required: Indica si el cliente tiene habilitados los emails de marketing

## Other responses

- `400`: Error de validación - página o pageSize inválidos (page >= 1, pageSize entre 1 y 1000)
- `401`: No autorizado - token de autenticación inválido o ausente

## Changes

- **2026-02-10** `3844e0145e23`: 1 info
  - endpoint added

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