REST API v1 (Deprecated)
VIP Tiers

VIP Tiers

List VIP programs

GET/rest_api/v1/tiers
Parameters
X-Joy-Loyalty-App-Keyheader · stringOptional
X-Joy-Loyalty-Secret-Keyheader · stringOptional
Responses
200OK
successbooleanOptional
tiersobject[]Optional
Show properties
idstringOptional
isSystemTierbooleanOptional
iconstringOptional
rateMoneystringOptional
iconCustomstringOptional
placedOrderRewardbooleanOptional
earnPointstringOptional
createdAtstring · date-timeOptional
targetPointintegerOptional
membersintegerOptional
namestringOptional
systemTypestringOptional
shopIdstringOptional
updatedAtstring · date-timeOptional
tierRewardsobject[]Optional
GET/rest_api/v1/tiers
GET /rest_api/v1/tiers HTTP/1.1
Host: dev-api.joy.so
Accept: */*
200OK
{
"success": true,
"tiers": [
{
"id": "3V2MEbloIVUmVhBbEzO1",
"isSystemTier": true,
"icon": "https://cdnapps.avada.io/joy/vip-tiers/icons/bronze.png",
"rateMoney": "",
"iconCustom": "",
"placedOrderReward": false,
"earnPoint": "",
"createdAt": "2023-07-14T04:08:05.498Z",
"targetPoint": 0,
"members": 0,
"name": "Bronze",
"systemType": "bronze",
"shopId": "nDaevBKY0zGCzmJz8mCv",
"updatedAt": "2023-07-14T04:08:05.498Z",
"tierRewards": []
},
{
"id": "15VYE9Go7vje7UVtfz3T",
"isSystemTier": true,
"icon": "https://cdnapps.avada.io/joy/vip-tiers/icons/silver.png",
"rateMoney": "",
"iconCustom": "",
"placedOrderReward": false,
"earnPoint": "",
"createdAt": "2023-07-14T04:08:05.499Z",
"targetPoint": 200,
"members": 0,
"name": "Silver",
"systemType": "silver",
"shopId": "nDaevBKY0zGCzmJz8mCv",
"updatedAt": "2023-07-14T04:08:05.499Z",
"tierRewards": []
},
{
"id": "YYDfREeDKmTmQTnkJTdE",
"isSystemTier": true,
"icon": "https://cdnapps.avada.io/joy/vip-tiers/icons/gold.png",
"rateMoney": "",
"iconCustom": "",
"placedOrderReward": false,
"earnPoint": "",
"createdAt": "2023-07-14T04:08:05.499Z",
"targetPoint": 500,
"members": 0,
"name": "Gold",
"systemType": "gold",
"shopId": "nDaevBKY0zGCzmJz8mCv",
"updatedAt": "2023-07-14T04:08:05.499Z",
"tierRewards": []
}
]
}

Get one VIP tier

GET/rest_api/v1/tiers/{tierId}
Parameters
X-Joy-Loyalty-App-Keyheader · stringOptional
X-Joy-Loyalty-Secret-Keyheader · stringOptional
tierIdpath · stringRequired
Responses
200OK
successbooleanOptional
tierobjectOptional
Show properties
idstringOptional
isSystemTierbooleanOptional
iconstringOptional
rateMoneystringOptional
iconCustomstringOptional
placedOrderRewardbooleanOptional
earnPointstringOptional
createdAtstring · date-timeOptional
targetPointintegerOptional
membersintegerOptional
namestringOptional
systemTypestringOptional
shopIdstringOptional
updatedAtstring · date-timeOptional
tierRewardsobject[]Optional
GET/rest_api/v1/tiers/{tierId}
GET /rest_api/v1/tiers/{tierId} HTTP/1.1
Host: dev-api.joy.so
Accept: */*
200OK
{
"success": true,
"tier": {
"id": "3V2MEbloIVUmVhBbEzO1",
"isSystemTier": true,
"icon": "https://cdnapps.avada.io/joy/vip-tiers/icons/bronze.png",
"rateMoney": "",
"iconCustom": "",
"placedOrderReward": false,
"earnPoint": "",
"createdAt": "2023-07-14T04:08:05.498Z",
"targetPoint": 0,
"members": 0,
"name": "Bronze",
"systemType": "bronze",
"shopId": "nDaevBKY0zGCzmJz8mCv",
"updatedAt": "2023-07-14T04:08:05.498Z",
"tierRewards": []
}
}

Get rewards for a specific tier

GET/rest_api/v1/tiers/rewards/{type}

Retrieve rewards based on tier type (tier_spending or tier_privileges) and a specific tier ID.

Parameters
X-Joy-Loyalty-App-Keyheader · stringOptional
X-Joy-Loyalty-Secret-Keyheader · stringOptional
typepath · stringRequired
tierIdFilterquery · stringRequired
Responses
200OK
dataobjectOptional
Show properties
dataobject[]Optional
Show properties
spendPointintegerOptional
showLoyaltyPagebooleanOptional
isTierPrivilegesbooleanOptional
redeemedintegerOptional
earnAmountstringOptional
titlestringOptional
typestringOptional
priorityintegerOptional
createdAtstring · date-timeOptional
translateTitleobjectOptional
redeemTypestringOptional
eventstringOptional
statusbooleanOptional
idstringOptional
expiredbooleanOptional
countintegerOptional
pageInfoobjectOptional
Show properties
hasNextbooleanOptional
hasPrebooleanOptional
GET/rest_api/v1/tiers/rewards/{type}
GET /rest_api/v1/tiers/rewards/{type} HTTP/1.1
Host: dev-api.joy.so
Accept: */*
200OK
{
"data": {
"spendPoint": 100,
"showLoyaltyPage": true,
"isTierPrivileges": false,
"redeemed": 23,
"earnAmount": "1",
"title": "Entry Reward Program",
"type": "tier_spending",
"priority": 0,
"createdAt": "2024-08-05T09:11:26.728Z",
"translateTitle": {
"it": ""
},
"redeemType": "fixed",
"event": "percentage_discount",
"status": true,
"id": "s7pBj30zXHhUMb6iWQHC",
"expired": false
},
"count": 1,
"pageInfo": {
"hasNext": false,
"hasPre": false
}
}
Product
Install AppWebsiteBook a Demo
Developers
JavaScript SDKREST API v2Webhook API
Company
Avada GroupHelp CenterContact
© 2026 Joy Loyalty by Avada Group. All rights reserved.