Get Applied or Available Promotions for Cart

Get a list of promotions. The API can return a sorted list of promotions based on the sortBy input parameter.

The filters parameter specifies the filters to use to determine the subset of promotions to return. Each filters parameter specifies the field and values to match. The fields parameter specifies the Promotion__c fields to return in the API response.

The filters parameter input is a comma-separated list of sObject fields and values. If one of the fields does not match any sObject fields, it will be discarded. If the filters parameter specifies multiple values separated by underscores, the API matches the field value with OR, for example, SubClass_c:HD_SD will match SubClassc='HD'OR SubClass_c='SD'.

To specify a promotion name using a locale other than the user's locale, set the localeCode parameter to the desired locale and the query parameter to the name of the promotion. For example:

This API supports the guest user enhancements that Salesforce introduced with the Winter ‘21 release. To encrypt and decrypt data for guest users, use the UserSecurity class with this API. See Guest User Technical Details.

For additional information, ​see UserSecurity Class and CPQ and Digital Commerce Changes for Guest Users.

Communication (vlocity_cmt)

For API parameter names and descriptions, see Cart-Based API Swagger Reference.