---
title: "Exportación de clientes"
method: GET
path: "/royalty/clients-export"
---

# Exportación de clientes

`GET /royalty/clients-export`

## Request

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

Obtiene una página de clientes optimizada para exportaciones masivas (BI). Usa keyset pagination por _id en lugar de skip/limit, lo que lo hace eficiente incluso con millones de registros. Pasar el nextLastSeenId de la respuesta anterior para obtener la siguiente página. nextLastSeenId null indica que no hay más páginas.

## Query parameters

- `pageSize` integer: Cantidad de clientes a retornar por página
- `lastSeenId` string: ID del último cliente recibido (cursor). Omitir en la primera llamada.

## Response `200`

Página de clientes para exportación

- object
  - `success` boolean, required
  - `data` object, required
    - `items` object[], required: Clientes de la página actual
      - `_id` string, required: ID del cliente
      - `createdAt` string, required: Fecha de creación del cliente en formato ISO 8601.
      - `name` string, required: Nombre completo del cliente
      - `email` string, required: Email del cliente
      - `phone` string, required: Teléfono del cliente
      - `firstLogin` string, required: Fecha del primer login en formato ISO 8601. Vacío si no tiene.
      - `lastLogin` string, required: Fecha del último login en formato ISO 8601. Vacío si no tiene.
      - `ordersCount` integer, required: Total de órdenes del cliente
      - `firstOrder` string, required: Fecha de la primera orden en formato ISO 8601. Vacío si no tiene.
      - `lastOrder` string, required: Fecha de la última orden en formato ISO 8601. Vacío si no tiene.
      - `pointsBalance` integer, required: Balance actual de puntos de lealtad
      - `marketingEmailEnabled` boolean, required: Indica si el cliente tiene habilitados los emails de marketing
    - `nextLastSeenId` string, nullable, required: ID del último cliente retornado, para usar como cursor en la siguiente llamada. null indica que no hay más páginas.
    - `pageSize` integer, required: Tamaño de página utilizado

## Other responses

- `400`: Error de validación - pageSize inválido (entre 1 y 1000)
- `401`: No autorizado - token de autenticación inválido o ausente

## Changes

- **2026-10-31** `4ad06bd631ce`: 1 info
  - added the required property `data/items/items/createdAt` to the response with the `200` status
- **2026-04-14** `d9aba9637846`: 1 info
  - endpoint added

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