Unfreeze line items
You can unfreeze Choice Products (Reward Link®, Promo Link™, Disbursement Link, or Global Choice Link) after they are successfully frozen. See how to freeze a line item.
A reward can be frozen to investigate errors or concerns. It can be frozen as many times as necessary as long as it’s fully unredeemed, and it's within a valid timeframe after the original date of issuance. Once a reward is frozen, the system will automatically unfreeze it after 48 hours if no other action is taken.
Note:
- You can manually unfreeze a reward if it's outside the five-day window and before the 48-hour window of automatic unfreeze ends. The system will automatically unfreeze a frozen reward after 48 hours if no other action is taken.
- You can only unfreeze Choice products.
- Freeze and unfreeze can occur on different dates after a reward is issued as long as each action falls within the allowable time windows.
How to unfreeze an existing line item?
See the steps below:
- Call
POST {URI}/line-items/{referenceLineItemid}/unfreeze
to unfreeze the reward. - Enter the
referenceLineItemID
for the line item you are planning to unfreeze. - Enter a reason code. A successful returned response is 202 Accepted.
- Call
GET {URI}/lineItems/{referenceLineItemID}
and enter the samereferenceLineItemID
. The status of this line item shows up as unfreeze in the payload.
Use the following endpoint to unfreeze a qualified line item.
Endpoint | Description |
---|---|
POST {URI}/line-items/{referenceLineItemID}/unfreeze | To unfreeze line items |
Use the following path parameter to identify which line item you're unfreezing:
Path parameter | Data type | Description |
---|---|---|
referenceLineItemID | string | (Required) Reference line item ID is returned in the line items response. |
Use the following body parameters to provide a reason for unfreezing your line item. See Get all reason codes for reasons and their descriptions:
Body | Data type | Description |
---|---|---|
reasonCode | Enum | (Required) The reason to unfreeze the line item. See Get all reason codes for reasons and their descriptions: -DELIVERY_INFO -REWARD_AMOUNT -REWARD_TYPE -VERIFIED_ORDER -FRAUD _OTHER |
otherReason | tring | This field is required if reasonCode equals OTHER. Enter a description why you need to unfreeze the line item only if the available reasonCodes don't meet your need. |
Here is the accepted response returned when unfreezing a line item is successful:
{
Accepted
}
If you try to unfreeze a line item that is already unfrozen, you will get 422 unprocessable .
{
"timestamp": "2025-02-14T18:20:46.859981268Z",
"requestId": "57aa9a08-385e-4075-b2d4-1d96477b08cd",
"path": "/raas/v2/lineItems/RG250106-133850-97-1/unfreeze",
"httpCode": 422,
"httpPhrase": "Unprocessable Entity",
"i18nKey": "422.234",
"message": "Line Item is ineligible to unfreeze."
}
The possible response codes for this endpoint are:
- 202 Accepted
- 400 Bad request
- 403 Forbidden
- 422 Unprocessable entity
Updated 2 days ago