Skip to main content
GET
Listar los movimientos de una membresía
Returns the movement history of one membership: every accrual, redemption, and correction, newest first. Each entry records the balance it produced, so the ledger is the audit trail behind the number on the card.

Endpoint

Required scope

loyalty:read

Headers

Path parameters

Query parameters

Example request

Response

200 OK

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the loyalty:read scope.

404 Not Found

No membership with that id in your company.

502 Bad Gateway

The loyalty service is unreachable.

Operational notes

  • amount is signed, kind is the intent. A redeem of 50 is stored as -50. Do not take the absolute value when summing — the entries add up as they are.
  • balance_after is the trustworthy figure. The first entry’s balance_after is the real balance. On a program with point expiry, the membership’s balance_points may read 0 while this still shows the accumulated total.
  • ref is your reconciliation handle. Nothing enforces uniqueness on it, but putting the receipt or order number there is what lets you match a movement back to the transaction that caused it.
  • Entries are immutable. There is no edit or delete. A mistake is corrected with an adjust movement, which leaves both the error and the correction visible.
  • This is per membership, not per customer. A customer enrolled in three programs has three separate ledgers.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Query Parameters

limit
number
default:50
Required range: 1 <= x <= 200
offset
number
default:0
Required range: x >= 0

Response

200 - application/json
total
number
required
limit
number
required
offset
number
required
data
object[]
required