Get List of Products

Return the list of products that match the specified criteria.

• Query with the text the customer enters

• Attributes

• Product hierarchy

• The last record ID from the previous search result, if available

• The page size of the number of products to return; the default is 20

  In Vlocity CMT V15, if the page size is set to 20, the API does not return images.

• Product IDs

Use includeAttachment to indicate whether product attachments are returned.

The value specified for attribute_code must be the Code of the Attribute, not the Name or ID.

The attributes filter for picklist type attributes takes into account all possible values, not just the selected value. If you want to filter based on specific Attribute Values, then assign the Attribute Value Type as Multi Picklist.

Use the includeIneligible=true parameter if you are using context rules to control product visibility in the product list. You can use the category field to see if a product is qualified or disqualified

To specify a product 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 product. For example:

Get Products replaces the OmniCPQServiceWrapper getProducts method.

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.