Get details for a specific line item
Use the following endpoint to retrieve the details such as reward credentials of a specific line item and the redemption history. For the real-time balance of the reward, you can subtract the redemption history from the total amount issued:
Endpoint | Description |
---|---|
GET {URI}/lineItems/{referenceLineItemID} | Get details for a specific line item. |
Here is a query parameter for this endpoint. The recipient address object is included in all returning payloads. The system autogenerates the identification, and you can find it by using the line item endpoint.
Query params | Data type | Description |
---|---|---|
referenceLineItemID | string | Reference line item ID is returned in the Line Items response. |
The following example shows the payload when you callGET {URI}/lineItems/{referenceLineItemID}
. The reward status indicates whether a reward is frozen or active.
credentailList
is a set of attributes that is returned on an order specifying how to access the purchased reward. credentailList
contains credential type, label, value, and other stable parameters. See how to Get credential type.
Note:
We have deprecated
credentials
. UsecredentialList
instead.
{
"referenceLineItemID": "string",
"referenceOrderID": "string",
"orderSource": "string",
"status": "string",
"orderStatus": "string",
"emailStatus": "string",
"deliveryMethod": "string",
"rewardStatus": "string",
"canCancel": true,
"canFreeze": true,
"lineNumber": 0,
"rewardName": "string",
"amountIssued": {
"value": 0,
"currencyCode": "string",
"exchangeRate": 0,
"fee": 0,
"total": 0
},
"amountCharged": {
"value": 0,
"currencyCode": "string",
"exchangeRate": 0,
"fee": 0,
"total": 0
},
"dateIssued": "2025-07-01T21:42:07.744Z",
"expirationDate": "2025-07-01T21:42:07.744Z",
"accountNumber": "string",
"accountIdentifier": "string",
"etid": "string",
"ptid": "string",
"utid": "string",
"customerIdentifier": "string",
"recipient": {
"email": "string",
"mobileNumber": "string",
"firstName": "string",
"lastName": "string",
"address": {
"streetLine1": "string",
"streetLine2": "string",
"city": "string",
"stateOrProvince": "string",
"postalCode": "string",
"country": "string"
}
},
"sender": {
"firstName": "string",
"lastName": "string",
"email": "string"
},
"purchaseOrderNumber": "string",
"campaign": "string",
"orderNotes": "string",
"lineItemActionReason": "string",
"reissuedFromReferenceLineItemId": "string",
"reissuedToReferenceLineItemId": "string",
"reward": {
"credentials": {
"additionalProp": "string"
},
"credentialList": [
{
"label": "string",
"value": "string",
"type": "string",
"credentialType": "string"
}
],
"redemptionInstructions": "string"
},
"redemptionHistory": [
{
"referenceLineItemID": "string",
"referenceOrderID": "string",
"orderSource": "string",
"status": "string",
"orderStatus": "string",
"emailStatus": "string",
"deliveryMethod": "string",
"rewardStatus": "string",
"canCancel": true,
"canFreeze": true,
"lineNumber": 0,
"rewardName": "string",
"amountIssued": {
"value": 0,
"currencyCode": "string",
"exchangeRate": 0,
"fee": 0,
"total": 0
},
"amountCharged": {
"value": 0,
"currencyCode": "string",
"exchangeRate": 0,
"fee": 0,
"total": 0
},
"dateIssued": "2025-07-01T21:42:07.744Z",
"expirationDate": "2025-07-01T21:42:07.744Z",
"accountNumber": "string",
"accountIdentifier": "string",
"etid": "string",
"ptid": "string",
"utid": "string",
"customerIdentifier": "string",
"recipient": {
"email": "string",
"mobileNumber": "string",
"firstName": "string",
"lastName": "string",
"address": {
"streetLine1": "string",
"streetLine2": "string",
"city": "string",
"stateOrProvince": "string",
"postalCode": "string",
"country": "string"
}
},
"sender": {
"firstName": "string",
"lastName": "string",
"email": "string"
},
"purchaseOrderNumber": "string",
"campaign": "string",
"orderNotes": "string",
"lineItemActionReason": "string",
"reissuedFromReferenceLineItemId": "string",
"reissuedToReferenceLineItemId": "string"
}
]
}
Here's an example payload for when you receive an error:
{
"timestamp": "2025-02-21T23:23:13.930Z",
"requestId": "string",
"path": "string",
"httpCode": 0,
"httpPhrase": "string",
"i18nKey": "string",
"message": "The error message will show here for error codes ",
"errors": [
{}
]
}
The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages:
- 200 OK
- 400 Bad request
- 401 Unauthorized
- 403 Forbidden
- 404 Not Found
Updated 11 days ago