Skip to main content

Get Rewards

List a loyalty member's available rewards. Supports limit and cursor-based pagination.

When to Use

Use this endpoint when:

  • Displaying a member's reward catalog
  • Building a rewards page in your member-facing UI

How to Use

Endpoint
GET/v3/loyalty/me/rewards

GET with countryCode, phoneNumber, optional limit, and optional cursor as query parameters.


Request Parameters

No request body. The member is identified by the countryCode and phoneNumber query parameters.

Response Parameters

itemsARRAY

Rewards object

Example: (Refer to explanation below)

codeSTRING

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

Example: "SUCCESS"

metaOBJECT

Inside meta have count key example "count": 2

Example: 2

Rewards object item:
idSTRING

Reward Id

Example: "1575971661443933008"

labelSTRING

Reward Label

Example: "Prudential RM 5 Cash Vouchers ( BoostPulse )"

imageUrlSTRING

Reward Image

Example: ""

pointINTEGER

Reward Point

Example: 1

payloadOBJECT

Refer to explanation below

tncARRAY

Example: ["T&C"]

contactInfoOBJECT

Refer to explanation below

emailSTRING

Email

Example: ""

phoneNumberSTRING

Phone Number

Example: ""

isShippingBOOLEAN

Reward shipping

Example: false

quantityINTEGER

Reward Quantity

Example: 49998

balanceQuantityINTEGER

Reward Balance Quantity

Example: 49991

usedQuantityINTEGER

Reward Used Quantity

Example: 2

redeemQuantityINTEGER

Reward Redeem Quantity

Example: 7

isEnabledBOOLEAN

Enable Reward

Example: true

limitPerUserINTEGER

Set Limit per User use

Example: 1

statusSTRING

Reward status have ("COMPLETED", "INPROGRESS", "FAILED", "EXPIRED")

Example: "COMPLETED"

isComboBOOLEAN

Reward is Combo

Example: false

typeSTRING

Reward type have Combo or Batch

Example: ""

createdAtDATETIME

Create date time

Example: "2020-11-18T06:43:19Z"

updatedAtDATETIME

Last update date time

Example: "2020-11-25T05:58:56Z"

expiredAtDATETIME

Expired date time

Example: "2018-10-19T03:39:47Z"