Get Reward List

This API is used to retrieve a list of available rewards that can be redeemed using customer loyalty points.

Endpoint

URL : {BaseURL}/api/v1/rewards/list
Method : GET
Header : Content-Type : Application/JSON
Header : Authorization : {{pwa_token}}

Request

This section describes the request parameters and provides examples of JSON requests used to retrieve available rewards.

Sample JSON Request

curl --location --globoff '{{BaseURL}}/api/v1/rewards/list' \
--header 'Authorization: {{pwa_token}}'

---

Response

This section describes the response parameters and provides JSON response examples returned by the API when retrieving available rewards.

Description Parameter Response

Field	Data Type	Mandatory	Format	Description
requestID	String (36)	YES	UUID	Unique identifier for the request.
rc	Integer (3)	YES	Numeric	Response code indicating the status of the operation.
Message	String (200)	YES	Alphanumeric	A descriptive message regarding the response.
data	Array	YES	Array	Contains a list of available vouchers. Each element represents a single voucher item.
id	String (36)	YES	UUID	Unique identifier for this voucher entry in the system.
voucherId	String (36)	YES	UUID	Unique ID of the Voucher.
voucherType	String (36)	YES	Alphanumeric	Type of voucher: PPOB (for digital/billing vouchers) or Non PPOB (for physical or merchant vouchers).
name	String (200)	YES	Alphanumeric	Display name of the voucher shown to the user.
points	Integer (10)	YES	Numeric	Number of points required to redeem this voucher.
image	String (200)	YES	URL	URL to the voucher image, usually showing the brand or product logo.
stock	Integer (10)	YES	Numeric	Number of voucher items currently available.
endDate	String (32)	YES	Timestamp	Expiration or redemption deadline of the voucher.

Sample JSON Response

{
	"requestID": "414c0d90-2f9b-46a8-b020-506dac9cfyyy",
	"rc": 200,
	"message": "success",
	"data": [
		{
			"id": "adcd67d3-8b85-4734-a571-b83535d69yyy",
			"voucherId": "fb5bf564-7919-45df-b652-bcc4fbab3yyy",
			"voucherType": "Non PPOB",
			"name": "ecom-1 Rp 50.000",
			"points": 52,
			"image": "{{BaseURL}}/api/service-product/api/v1/product-non-ppob/image/e8ad32a7-bd47-4d28-ace7-1bd2d8a142db.png",
			"stock": 16,
			"endDate": "2026-12-31T00:00:00+07:00"
		},
		{
			"id": "cf3255bd-995e-4805-a1de-59ca71206yyy",
			"voucherId": "9f32db98-bfdc-49d2-8711-9d1e44f6cyyy",
			"voucherType": "Non PPOB",
			"name": "ehotel-1 Rp 50.000",
			"points": 53,
			"image": "{{BaseURL}}/api/service-product/api/v1/product-non-ppob/image/56dad473-6487-445f-8621-9e5402494a16.png",
			"stock": 7,
			"endDate": "2026-12-31T00:00:00+07:00"
		},
		{
			"id": "5ca5bbeb-b988-4283-bc14-b5eb84576aa1",
			"voucherId": "62fba57c-737c-4697-9551-190df4a514ec",
			"voucherType": "Non PPOB",
			"name": "ehotel-2 Rp 100.000",
			"points": 107,
			"image": "{{BaseURL}}/api/service-product/api/v1/product-non-ppob/image/f3f519e5-f67b-4563-87f3-a16c2af47a5d.png",
			"stock": 5,
			"endDate": "2026-12-31T00:00:00+07:00"
		},
		{
			"id": "5e18d7ae-fad6-4d2d-9f9e-16b420ab133f",
			"voucherId": "9fd27e68-f4ec-419f-afbb-2eb3f6cb2499",
			"voucherType": "Non PPOB",
			"name": "ecom-2 Rp 50.000",
			"points": 50,
			"image": "{{BaseURL}}/api/service-product/api/v1/product-non-ppob/image/4a486fd2-1c2b-4e6a-adc8-3c8618d31e70.png",
			"stock": 9,
			"endDate": "2026-12-31T00:00:00+07:00"
		}
	]
}