This API endpoint retrieves the details of a specific vendor redemption associated with a specific vendor and redemption ID. It allows brands to access information about the redemption status and related details.
Example request
curl --location 'https://eu.api.capillarytech.com/api_gateway/rewards/core/v1/vendor/430/redemption/36987/brand/61' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--header 'Authorization: Basic bWFkaHVfcmMjU2YQ==' \
--header 'Cookie: _cfuvid=vN5wfiWeYZXwnooleui8wohWfs.JTIrPyd1SjnuHz_4-1764227099805-0.0.1.1-604800000'Prerequisites
- Authentication: Basic or OAuth authentication
- Default access group
API Specification
| URI | /api_gateway/rewards/core/v1/vendor/{vendorid}/redemption/{redemptionid}/brand/{brandid} |
| HTTP Method | GET |
| Pagination | Yes |
| Batch support | No |
| Rate limit information | None |
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| vendorId | Long | The unique identifier of the vendor. |
| redemptionId | Long | The unique identifier of the redemption. |
| brandId | Long | The unique identifier of the brand associated with the redemption. |
Example response
{
"status": {
"success": true,
"code": 5011,
"message": "Vendor redemption fetched successfully"
},
"redemption": {
"id": 36987,
"name": "UAT Vendor Redemption 6",
"enabled": true,
"responseKeys": [
"voucher"
],
"lastUpdatedOn": 1764153001000,
"lastUpdatedOnDateTime": "2025-11-26T10:30:01Z",
"redemptionType": "INTOUCH_REWARD",
"vendorId": 430,
"vendorName": null,
"createdBy": 75197372,
"lastUpdatedBy": 75197372,
"createdOn": 1764153001000,
"createdOnDateTime": "2025-11-26T10:30:01Z",
"redemptionActionList": [
{
"id": 27321,
"name": "add good will points",
"enabled": true,
"apiType": "POST",
"apiUrl": "https://crm-nightly-new.cc.capillarytech.com/v1.1/request/add?program_id=2851",
"apiHeaders": {
"Authorization": "Basic bHVjaWF1dG9fdGlsbF8xMDoyMDJjYjk2MmFjNTkwNzViOTY0YjA3MTUyZDIzNGI3MA==",
"accept": "application/json",
"Content-Type": "application/json"
},
"apiBody": "{\"customFields_property\": {\"customField_1_property\": \"${customfield_CF1}\"}, \"transactionId_property\": \"${rewardTransactionId}\", \"fulfillmentStatus_property\": \"${fulfillmentStatus}\"}",
"execOrder": 1,
"contextKeys": {
"voucher": "response.requests.request.get(0).id"
},
"retryAction": false
}
]
}
}Response parameters
Parameter Name | Data Type | Description |
|---|---|---|
status | Object | Contains the status details of the vendor redemption. |
-success | Boolean | Indicates if the request was successful. |
-code | Integer | Status code of the response. |
-message | String | Message describing the status of the response. |
redemptionList | Array | List of vendor redemptions. |
-id | Long | Unique ID of the vendor redemption. |
-name | String | Name of the vendor redemption. |
-enabled | Boolean | Indicates if the vendor redemption is enabled. |
-responseKeys | Array | A list of response keys expected from the vendor API. |
-lastUpdatedOn | Long | Indicates the timestamp when the vendor redemption was updated. The timestamp is in Epoch time format. |
-lastUpdatedOnDateTime | String | Indicates the date and time when the vendor redemption was updated, formatted in ISO 8601 |
-redemptionType | String | Type of redemption (e.g. MILES). |
-vendorId | long | The Unique identifier of the vendor whose information is being fetched. |
-vendorName | string | The unique name of the vendor. |
-createdBy | Long | The unique identifier of the user who created the vendor redemption. |
-lastUpdatedBy | Long | The unique identifier of the user who last updated the vendor redemption record. |
-createdOn | Long | Indicates the timestamp when the vendor redemption was created. The timestamp is in Epoch time format. |
-createdOnDateTime | String | Indicates the date and time when the vendor redemption was created, formatted in ISO 8601. |
-redemptionActionList | array | List of vendor redemptions fetched in the response. |
--id | long | Unique ID of the vendor redemption. |
--name | string | Name of the vendor redemption. |
--enabled | boolean | Indicates if the vendor redemption is enabled. |
--apiType | string | The HTTP method to be used for the API request. |
--apiUrl | string | The URL to which the API request is made. For example, "apiUrl": "https://partial.com/reward/issue" specifies the endpoint where the request to issue a reward will be made. |
--apiHeaders | object | An object containing the headers to be sent with the API request. |
---Authorization | String | The authorization header containing the authentication credentials. |
---Content-Type | String | The content type header indicating the format of the request body. |
--apiBody | String | The API body for the external API endpoint specified in apiUrl. You can also include custom fields, fulfillment status, and reward transaction ID. The fulfillment status and reward transaction ID are variables resolved in the backend according to the associated transaction. |
--execOrder | Integer | The execution order of the action. |
--contextKeys | Object | An object containing context keys for extracting values from the response. |
--retryAction | Boolean | Indicates whether the action should be retried on failure (true/false). |
actionCount | Integer | Number of actions configured for this redemption setup. |
