Vendor Redemption Details by Brand ID and Vendor ID

This API endpoint retrieves the details of a specific vendor redemption associated with a specific vendor and brand ID.

Endpoint

GET /api_gateway/rewards/core/v1/vendor/{vendorId}/redemption/brand/{brandId}

Path Parameters

Parameter NameData TypeDescription
vendorIdLongUnique identifier for the vendor whose redemption details are being requested.
brandIdLongUnique identifier for the brand associated with the vendor redemption.

Sample Request

curl --location 'https://eu.api.capillarytech.com/api_gateway/rewards/core/v1/vendor/133/redemption/brand/61?page=1&size=10&order=DESC&sortOn=LAST_UPDATED_ON' \
--header 'Authorization: Basic <Base64EncodedCredentials>'

Response Parameters

Parameter NameData TypeDescription
statusObjectContains the status details of the vendor redemption.
successBooleanIndicates if the request was successful.
codeIntegerStatus code of the response.
messageStringMessage describing the status of the response.
redemptionListArrayList of vendor redemptions.
idLongUnique ID of the vendor redemption.
nameStringName of the vendor redemption.
redemptionTypeStringType of redemption (e.g. MILES).
enabledBooleanIndicates if the vendor redemption is enabled.
lastUpdatedOnLongIndicates the timestamp when the vendor redemption was updated. The timestamp is in Epoch time format.
lastUpdatedOnDateTimeStringIndicates the date and time when the vendor redemption was updated, formatted in ISO 8601
actionCountIntegerNumber of actions configured for this redemption setup.
createdByLongThe till ID of the user who created the vendor redemption.
lastUpdatedByLongThe till ID of the user who last updated the vendor redemption record.
createdOnDateTimeStringIndicates the date and time when the vendor redemption was created, formatted in ISO 8601.
createdOnLongIndicates the timestamp when the vendor redemption was created. The timestamp is in Epoch time format.

Sample Response

{
  "status": {
    "success": true,
    "code": 5011,
    "message": "Vendor redemption fetched successfully"
  },
  "redemptionList": [
    {
      "id": 27235,
      "name": "jotest",
      "redemptionType": "VOUCHER",
      "enabled": false,
      "lastUpdatedOn": 1748341052000,
      "lastUpdatedOnDateTime": "2025-05-27T10:17:32Z",
      "actionCount": 1,
      "createdBy": 75161973,
      "lastUpdatedBy": 75161973,
      "createdOn": 1747308132000,
      "createdOnDateTime": "2025-05-15T11:22:12Z"
    }
  ],
  "pagingDetails": {
    "last": true,
    "totalElements": 5,
    "totalPages": 1,
    "numberOfElements": 5,
    "first": true,
    "size": 10,
    "number": 1
  }
}

Response Codes

CodeMessageDescription
5011Vendor redemption fetched successfullyRedemption configurations were retrieved.
400Bad RequestRequest is malformed or missing required parameters.
401UnauthorizedInvalid or missing authentication credentials.
404Not FoundVendor or brand not found.
500Internal Server ErrorAn error occurred on the server.

Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!