Get Loyalty Member History

Retrieve a loyalty member's point history — earnings, redemptions, and adjustments.

When to Use

▾

Use this endpoint when:

• Displaying a member's point activity in their profile
• Auditing point transactions for a specific member

How to Use

▾

Endpoint

GET/v3/loyalty/member/{memberId}/history

GET /v3/loyalty/member/{memberId}/history.

---

Request Parameters

▾

note

• The URL is consists of [base_URL]/v3/loyalty/member/[member_id]/history

• Pass an empty JSON object Example: {}

Response Parameters

▾

itemsARRAY

Array of loyalty history records

keySTRING

History record key (internal usage)

Example: "EhIKBk1lbWJlchCpzIGbrcmr_BUSGQoNTWVtYmVyUHJvZmlsZRDclJuNr8mr_BUSGgoOTG95YWx0eUhpc3RvcnkQlYaaufPqrPwV"

merchantKeySTRING

Merchant key (internal usage)

Example: "EhQKCE1lcmNoYW50EJXVzd3wraqTOQ"

typeSTRING

History record type (e.g. VOUCHER_REDEEM, CREDIT_TOP_UP, QR_CODE_REDEEM)

Example: "VOUCHER_REDEEM"

descriptionSTRING

Description of the record

Example: "voucher combo voucher redeemed"

pointINTEGER

Loyalty point change (can be negative)

Example: -4

creditINTEGER

Credit change

Example: 0

creditBalanceINTEGER

Credit balance after this record

Example: 1

createdAtDATETIME

Creation date time

Example: "2020-03-03T05:14:16Z"

updatedAtDATETIME

Last update date time

Example: "2020-03-03T05:14:16Z"

codeSTRING

Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)

Example: "SUCCESS"

metaOBJECT

Pagination metadata

countINTEGER

Total number of records returned

Example: 4