Vendor Redemption Details by Redemption & Vendor ID

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.

Prerequisites

  • Authentication: Basic or OAuth authentication
  • Default access group

API Specification

URI/api_gateway/rewards/core/v1/vendor/{vendorid}/redemption/{redemptionid}/brand/{brandid}
HTTP MethodGET
PaginationYes
Batch supportNo
Rate limit informationNone

API endpoint

http://{host}/api_gateway/rewards/core/v1/vendor/{vendorid}/redemption/{redemptionid}/brand/{brandid}

Path Parameters

ParameterTypeDescription
vendorIdLongThe unique identifier of the vendor.
redemptionIdLongThe unique identifier of the redemption.
brandIdLongThe unique identifier of the brand associated with the redemption.

Request Query Parameters

Parameter NameData TypeDescription
sizeIntegerSpecifies the number of results to return per page. Used for pagination.
pageIntegerIndicates the page number to retrieve. Used with size to paginate results.
orderbyStringSort order of the results. Supported values: ASC, DESC. Default is ascending.
sortOnEnumField to sort results by. Supported value: LAST_UPDATED_ON.

curl --location 'http://eu.api.capillarytech.com/api_gateway/rewards/core/v1/vendor/133/redemption/27570/brand/61' \
--header 'Authorization: Basic Z2VvcmdlLmpvaG5zb246OTg4OTU2NWI4ODVhMmY4ZWE1MTk1MjA2NWEwYTEzNzg=' \
--header 'Cookie: _cfuvid=UltnS7qhT6yBRdUKLfbrb797jULJRoy5vzEiNF2Lz6w-1748339721401-0.0.1.1-604800000' \
--data ''

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
  }
}
Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!