Listar los movimientos de una membresía
Ledger
GET /v1/loyalty/memberships/{id}/ledger
List the point or stamp movements of a membership, newest first, each with the balance it produced.
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 theloyalty:read scope.
404 Not Found
No membership with that id in your company.502 Bad Gateway
The loyalty service is unreachable.Operational notes
amountis signed,kindis the intent. Aredeemof50is stored as-50. Do not take the absolute value when summing — the entries add up as they are.balance_afteris the trustworthy figure. The first entry’sbalance_afteris the real balance. On a program with point expiry, the membership’sbalance_pointsmay read0while this still shows the accumulated total.refis 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
adjustmovement, 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
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Path Parameters
Query Parameters
Required range:
1 <= x <= 200Required range:
x >= 0