Skip to content

This API call allows you to change the status of a reward from the server side directly


We have already laid out how there are 4 different statuses that a reward could be attested with, at any moment, depending on the rules of the campaign and the conversion event encountered.

Often, you would find it more comfortable to handle the change in these status directly from your side, instead of waiting for AppVirality to update them. This API call comes in handy for that.

Example: You would like to override and change status of a reward (which is linked to the Conversion event) immediately after you have confirmation that the product has been delivered successfully & no returns would be filed for the same.
This would allow you to update the user rewards as soon as the user states that he would not be returning the order

POSTapi.appvirality.com/saas/v1_0/changerewardstatusapplication/json

Input i.e. Request

{
"apikey":"7ffdda00fd5c4338a9c1a44e00663648",
"privatekey":"d1e881dc60fa4856be34a44f00d96c9a",
"rewardslist":[
{
"rewarddtlid":"797",
"rewardstatus":"Approved",
"message":"Status changed from Rejected to Approved"
}
]
}

Input Params

Input ParamsDescription
apikeyAPI Key of the Product
Get it from DashboardApp Details
privatekeyPrivate key for API requests
Get it from: DashboardApp Details › Click App SettingsAdvanced
rewardslistRewards List
~ rewarddtlidReward Detail ID
~ rewardstatusReward status can be: Approved, Rejected, Suspicious, Under Review
~ messageAny custom message

Response

{
"success":true,
"message":null
}

Response Params

Output ParamsDescription
successreturns true on successful update
messageInformation regarding API call (if relevant)