Get purchased reward details by id and user

This API is used to get the details for a particular reward for a specific user based on mobile number/email ID/external ID.



For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call .


  • Authentication: Basic or OAuth authentication
  • Default access group

Resource information

URI/api_gateway/rewards/core/v1/user/reward/{reward Id}/vouchers/brand/{brand name}
Batch supportNo
Rate limit informationNone

API endpoint example

Request query parameters

Parameter NameData TypeDescription
MobileStringMobile number of the customer
Username*StringUsername of the customer
EmailStringEmail ID of the customer
External IDStringExternal ID of the customer.

Request path parameters

Parameter NameData TypeDescription
brand name*StringName of the brand Ex: BUKL
rewardId*StringUnique identifier of the reward Ex: 112295

Response parameters

Parameter NameData TypeDescription
successBooleanIndicates if the operation was successful.
codeIntegerThe HTTP status code of the operation.
messageStringDescriptive message about the operation's outcome.
idIntegerUnique identifier of the reward.
nameStringName of the reward.
descriptionStringDescription of the reward.
imageIdStringUnique identifier for the main image of the reward.
imageUrlStringURL for the main image of the reward.
thumbnailIdStringUnique identifier for the thumbnail image of the reward.
thumbnailUrlStringURL for the thumbnail image of the reward.
termAndConditionsIdStringUnique identifier for the terms and conditions document of the reward.
termAndConditionsUrlStringURL to the terms and conditions document of the reward.
tierStringTier level associated with the reward.
labelStringLabel associated with the reward.
priorityIntegerPriority level of the reward.
intouchPointsIntegerNumber of points needed to redeem the reward.
groupStringGroup associated with the reward.
startTimeDateTimeStart time for the reward's availability.
endTimeDateTimeEnd time for the reward's availability.
expiredBooleanIndicates whether the reward is expired.
startedBooleanIndicates whether the reward has started.
programIdIntegerIdentifier for the program associated with the reward.
categoryListObjectList of categories associated with the reward.
customFieldsObjectKey-value pairs for custom fields associated with the reward.
loyaltyProgramCriteriaArrayCriteria for loyalty programs associated with the reward.
restrictionsObjectRestrictions associated with the reward.
appliedPromotionsArrayList of applied promotions associated with the reward.
groupNameStringName of the group associated with the reward.
groupRankIntegerRank of the group associated with the reward.
rewardRankIntegerRank of the reward within its category or program.
imagesArrayList of additional images associated with the reward.
videosArrayList of videos associated with the reward.
rewardRevenueDetailsObjectThe list of brand commission and end customer details.
brandCommissionFloatCommission earned by the brand.
endCustomerCommissionFloatCommission earned by the end customer after the transaction.
    "status": {
        "success": true,
        "code": 200,
        "message": "User Reward fetched successfully"
    "reward": {
        "id": 7712,
        "name": " INTOUCH Enabled",
        "description": "Description",
        "imageId": "EXDR12987U",
        "imageUrl": "",
        "thumbnailId": "EXDR12987T",
        "thumbnailUrl": "",
        "termAndConditionsId": "EXDR12987R",
        "termAndConditionsUrl": "",
        "tier": "SILVER",
        "label": null,
        "priority": 1,
        "intouchPoints": 1,
        "group": null,
        "startTime": "2024-10-07 17:04:30",
        "endTime": "2027-10-31 05:39:49",
        "expired": false,
        "started": false,
        "programId": null,
        "categoryList": [
                "id": 5,
                "name": "ecommerce",
                "enabled": true
        "customFields": {
            "0a17": "defaultValue",
            "a8a6": "defaultValue",
            "2d8a": "defaultValue",
        "loyaltyProgramCriteria": [],
        "rewardRestrictions": {
            "isValid": true
        "appliedPromotions": [],
        "groupName": null,
        "groupRank": null,
        "rewardRank": null,
        "images": [],
        "videos": [],
        "rewardRevenueDetails": {
            "brandCommission": 0,
            "endCustomerCommission": 1.30
Click Try It! to start a request and see the response here!