Mi historial

Los movimientos del usuario en el programa: consumos, compras de beneficios, canjes y recompensas.

GET/v1/me/activityToken del usuario

Movimientos del usuario en el programa del comercio: consumos que sumaron puntos, compras de beneficios, canjes y recompensas especiales.

Paginado por cursor: para traer la página siguiente se pasa el next_cursor de la respuesta anterior en ?cursor=.

Headers

X-Commerce-Idintegerheaderrequerido

Id del comercio que integra la API. Todas las respuestas quedan limitadas a este comercio.

Parámetros

cursorstring | nullquery

Cursor de la página a traer. Se obtiene del next_cursor de la respuesta anterior. Sin especificar, trae la primera página.

Respuesta

resultsarray de movimientosrequerido

Los movimientos de esta página. Ver Movimiento.

next_cursorstring | null

Se pasa como ?cursor= para traer la página siguiente. null cuando no hay más.

previous_cursorstring | null

El cursor de la página anterior.

Ejemplo

curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me/activity \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Commerce-Id: 87"

// 200 OK
{
  "results": [
    {
      "type": "consumption",
      "date": "2026-08-20T18:42:00Z",
      "points": 17,
      "benefit": null,
      "amount": 1750,
      "event": null,
      "additional_note": null
    },
    {
      "type": "benefit_exchange",
      "date": "2026-08-24T13:05:00Z",
      "points": -250,
      "benefit": {
        "id": "b_9f2a",
        "type": "percentage_discount",
        "description": "20% de descuento en toda la tienda",
        "cost": 250,
        "expiration": "2026-12-31T23:59:59Z",
        "benefit_type": "normal",
        "color": "#f1a10d",
        "buy_limit": 0,
        "prize": null,
        "tiendanube_coupon": null
      },
      "amount": null,
      "event": null,
      "additional_note": null
    }
  ],
  "next_cursor": "eyJkIjoiMjAyNi0wOC0yMCJ9",
  "previous_cursor": null
}

Los cuatro tipos de movimiento

`type`	Qué pasó	Campos que trae
`consumption`	Una compra que sumó puntos	`amount`, `points`
`benefit_exchange`	Compró un beneficio con puntos	`benefit`, `points` (negativo)
`benefit_usage`	Canjeó un beneficio en el comercio	`benefit`
`points_special_reward`	Una recompensa automática le dio puntos	`event`, `points`

Como los campos que vienen cargados dependen del type, conviene armar la fila del historial con un switch sobre type y no leer todos los campos siempre.

Errores

Código	Cuándo
`401`	El token de acceso falta, venció o no corresponde a un usuario final.
`422`	Falta el header `X-Commerce-Id`.