Member Vouchers

Retrieve a list of vouchers issued to the member, while asynchronously requesting data from the Member Vouchers API.

Parameter NameTypeDescriptionRequired or Optional
membershipNumberStringUnique identifier of the member whose vouchers are being retrieved.Required
devModeBooleanIndicates whether the request is run in developer mode (true) ot not (false).Optional
pageNumberIntegerThe page number to be returned. If you don’t specify a value, the first page is returned. Each page contains 200 vouchers, sorted by their date of creation.Optional
productCategoryIdStringThe ID of a product category associated with the member vouchers to be retrieved. You can specify up to 20 product category IDs.Optional
productCategoryNameStringThe product category name associated with the vouchers to be retrieved. You can specify up to 20 product categories.Optional
productIdStringThe product ID associated with the vouchers to be retrieved. You can specify up to 20 product IDs.Optional
productNameStringThe product name associated with the vouchers to be retrieved. You can specify up to 20 product names.Optional
voucherStatusStringThe status of the member vouchers to filter the API response. Possible values are Issued, Cancelled, or Expired.Optional
sortByStringThe voucher field for sorting the API response. The default value is ExpirationDate. Possible values are CreatedDate, EffectiveDate, or ExpirationDate.Optional
sortOrderStringThe sort order of the API response. The default value is Ascending. Possible values are Ascending or Descending.Optional
versionStringVersion of the API. The request body is available in version 55.0 and later.Optional
Property NameTypeDescription
attributesUrlStringThe URL of the attribute associated with the voucher.
currencyIsoCodeStringThe currency ISO code in which the member has redeemed the voucher.
descriptionStringThe description of the voucher issued to the member.
discountPercentIntegerThe discount percentage that’s offered to the member by the voucher.
effectiveDateStringThe date the member can redeem the voucher.
expirationDateStringThe date the voucher expires.
faceValueDoubleThe value that the member can redeem using the voucher.
idStringThe ID of the voucher record.
isVoucherDefinitionActiveBooleanIndicates whether the voucher definition associated with the voucher is active (true) or not (false).
isVoucherPartiallyRedeemableBooleanIndicates whether the voucher can be redeemed across multiple transactions (true) or only one transaction (false).
partnerAccountStringThe name of the partner associated with the voucher’s voucher definition.
productStringThe name of the product associated with the voucher definition.
productCategoryStringThe product category associated with the voucher’s voucher definition.
productCategoryIdStringThe ID of product category associated with the voucher’s voucher definition.
productIdStringThe ID of the product associated with the voucher definition.
promotionIdStringThe ID of the promotion for which the voucher is issued.
promotionNameStringThe name of the promotion for which the voucher is issued.
redeemedValueDoubleThe value that the member has already redeemed from a partially redeemable voucher.
remainingValueDoubleThe remaining value of the voucher after partial redemption.
statusStringThe status of the voucher.
typeStringThe type of voucher issued to the member.
useDateStringThe date the voucher was redeemed.
voucherCodeStringThe code of the voucher.
voucherDefinitionStringThe name of the voucher definition used to issue the voucher to the member.
voucherImageUrlStringThe URL of the image associated with the voucher definition. In the promotion record, enter an image URL and ensure that the webpage that hosts the image is publicly accessible.
voucherNumberStringThe unique number of the voucher.