GEgetjusto

Movimientos de puntos de lealtad

Changed on

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

get/royalty/client-point-movements

Request

  • Base URL
    https://api.service.getjusto.com/v3
  • Auth
    HTTP bearer

Query parameters

justoUserIdstring

ID del usuario de Justo

startDatestring

Fecha de inicio del rango (formato YYYY-MM-DD o ISO 8601, ej: 2026-01-19 o 2026-01-19T00:00:00Z)

Example:2026-01-01
endDatestring

Fecha de fin del rango (formato YYYY-MM-DD o ISO 8601, ej: 2026-01-19 o 2026-01-19T23:59:59Z)

Example:2026-01-31
type'manual' | 'redemption' | 'accumulation' | 'referral' | 'expiration' | 'refund'

Tipo de movimiento a filtrar

pageinteger

Número de página a obtener

pageSizeinteger

Cantidad de elementos por página

Response

Lista paginada de movimientos de puntos de lealtad

successboolean required

Indica si la operación fue exitosa

Example response

{
  "success": true,
  "data": {
    "movements": [
      {
        "amount": 50,
        "userId": "u-001",
        "createdAt": "2025-01-20T14:30:00.000Z",
        "balance": 150,
        "direction": "in",
        "originReference": {
          "type": "accumulation",
          "expiresAt": "2026-01-20T14:30:00.000Z",
          "orderId": "ord-001",
          "orderCode": "ORD-12345",
          "tabId": "tab-001",
          "description": "Orden Online"
        }
      }
    ],
    "pagination": {
      "totalCount": 150,
      "page": 1,
      "pageSize": 100,
      "totalPages": 2,
      "hasNextPage": true
    }
  }
}

Changes

  • 43bab2b2bbb0Revision changes
    • info

      the query request parameter justoUserId became optional

  • 530b4bc771feRevision changes
    • breaking

      the query request parameter type was restricted to a list of enum values

    • breaking

      the query request parameter justoUserId became required

    • warning

      deleted the query request parameter clientId

    • warning

      deleted the query request parameter email

    • warning

      added the new accumulation enum value to the //// response property for the response status

    • warning

      added the new manual enum value to the //// response property for the response status

    • warning

      added the new redemption enum value to the //// response property for the response status

    • warning

      added the new referral enum value to the //// response property for the response status

    • info

      added the new enum value accumulation to the query request parameter type

    • info

      added the new enum value expiration to the query request parameter type

    • info

      added the new enum value manual to the query request parameter type

    • info

      added the new enum value redemption to the query request parameter type

    • info

      added the new enum value referral to the query request parameter type

    • info

      added the new enum value refund to the query request parameter type

    • info

      removed the adjustment enum value from the //// response property for the response status

    • info

      removed the order enum value from the //// response property for the response status

    • info

      removed the other enum value from the //// response property for the response status