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?countryCode={countryCode}&phoneNumber={phoneNumber}

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"